remotion-dev/remotion · error · Error

Config.setImageFormat() has been renamed - use Config.setVid

Error message

Config.setImageFormat() has been renamed - use Config.setVideoImageFormat() instead (default "jpeg"). For rendering stills, use Config.setStillImageFormat() (default "png")

What it means

`Config.setImageFormat()` was ambiguous (used for both video and stills) and was split into `Config.setVideoImageFormat()` (default `jpeg`) and `Config.setStillImageFormat()` (default `png`). The old name still exists on `Config` but throws to drive callers to the correct replacement.

Source

Thrown at packages/cli/src/config/index.ts:801

	setTimeoutInMilliseconds: delayRenderTimeoutInMillisecondsOption.setConfig,
	setDelayRenderTimeoutInMilliseconds:
		delayRenderTimeoutInMillisecondsOption.setConfig,
	setChromiumDisableWebSecurity: disableWebSecurityOption.setConfig,
	setChromiumIgnoreCertificateErrors: ignoreCertificateErrorsOption.setConfig,
	setChromiumHeadlessMode: headlessOption.setConfig,
	setChromiumOpenGlRenderer: glOption.setConfig,
	setChromiumUserAgent: userAgentOption.setConfig,
	setDotEnvLocation: envFileOption.setConfig,
	setConcurrency: concurrencyOption.setConfig,
	setChromiumMultiProcessOnLinux: enableMultiprocessOnLinuxOption.setConfig,
	setChromiumDarkMode: darkModeOption.setConfig,
	setQuality: () => {
		throw new Error(
			'setQuality() has been renamed - use setJpegQuality() instead.',
		);
	},
	setImageFormat: () => {
		throw new Error(
			'Config.setImageFormat() has been renamed - use Config.setVideoImageFormat() instead (default "jpeg"). For rendering stills, use Config.setStillImageFormat() (default "png")',
		);
	},
	setJpegQuality: jpegQualityOption.setConfig,
	setStillImageFormat: stillImageFormatOption.setConfig,
	setVideoImageFormat: videoImageFormatOption.setConfig,
	setMetadata,
	setEncodingMaxRate: encodingMaxRateOption.setConfig,
	setEncodingBufferSize: encodingBufferSizeOption.setConfig,
	setFrameRange: framesOption.setConfig,
	setScale: scaleOption.setConfig,
	setEveryNthFrame: everyNthFrameOption.setConfig,
	setNumberOfGifLoops: numberOfGifLoopsOption.setConfig,
	setMuted: mutedOption.setConfig,
	setEnforceAudioTrack: enforceAudioOption.setConfig,
	setOutputLocation,
	setOverwriteOutput: overwriteOption.setConfig,
	setChromeMode: chromeModeOption.setConfig,

View on GitHub (pinned to 78fe4bb3fd)

Solutions

1. If you mean the per-frame video image format, use `Config.setVideoImageFormat('jpeg')`.
2. If you mean the still image format (for `remotion still`), use `Config.setStillImageFormat('png')`.

Example fix

// before
Config.setImageFormat('jpeg');
// after
Config.setVideoImageFormat('jpeg');
// (or Config.setStillImageFormat('png') for stills)

const src = readFileSync('remotion.config.ts', 'utf8');
if (/Config\.setImageFormat\(/.test(src)) {
  throw new Error('Replace Config.setImageFormat() with setVideoImageFormat()/setStillImageFormat().');
}

When it happens

Trigger: Calling `Config.setImageFormat('jpeg')` in a remotion config file. The throw fires at call time.

Common situations: Pre-split config file from an older Remotion; tutorial that pre-dates the rename; automated codemod that missed this setter.

Related errors

• The config format has changed. Change `Config.Bundling.*()`
• The config format has changed. Change `Config.Rendering.*()`
• The config format has changed. Change `Config.Output.*()` ca
• The config format has changed. Change `Config.Log.*()` calls
• The config format has changed. Change `Config.Preview.*()` c

AI-assisted analysis of remotion-dev/remotion@78fe4bb3fd (2026-08-12). Data as JSON: /api/errors/beddc3c67a312989. Report an issue: GitHub.