remotion-dev/remotion · error · Error

setQuality() has been renamed - use setJpegQuality() instead

Error message

setQuality() has been renamed - use setJpegQuality() instead.

What it means

`Config.setQuality()` was renamed to `Config.setJpegQuality()` to make its scope explicit (JPEG quality only). The old name still exists on `Config` but its body throws so un-migrated config files fail with a clear message instead of silently changing behavior.

Source

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

	setPublicDir: publicDirOption.setConfig,
	setEntryPoint,
	setLogLevel: logLevelOption.setConfig,
	setLevel: logLevelOption.setConfig,
	setBrowserExecutable: browserExecutableOption.setConfig,
	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,

View on GitHub (pinned to 78fe4bb3fd)

Solutions

  1. Rename the call to `Config.setJpegQuality(80)`.
  2. Confirm the value is in the valid JPEG quality range (1-100).

Example fix

// before
Config.setQuality(80);
// after
Config.setJpegQuality(80);
Defensive patterns

Strategy: validation

Validate before calling

const src = readFileSync('remotion.config.ts', 'utf8');
if (/Config\.setQuality\(/.test(src)) {
  throw new Error('Rename Config.setQuality() to Config.setJpegQuality().');
}

Prevention

When it happens

Trigger: Calling `Config.setQuality(80)` (or any value) in a remotion config file. The throw happens at call time, regardless of argument.

Common situations: Long-lived config file from before the rename; copied snippet from older docs; IDE autocomplete offering the old name from cached types.

Related errors


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