remotion-dev/remotion · error · TypeError

The `<OffthreadVideo>` tag does no longer accept `imageForma

Error message

The `<OffthreadVideo>` tag does no longer accept `imageFormat`. Use the `transparent` prop if you want to render a transparent video.

What it means

The `imageFormat` prop on `<OffthreadVideo>` was removed in a Remotion version because frame-extraction format is now controlled by the `transparent` boolean. The component throws a `TypeError` if the legacy prop is still passed to make the migration visible.

Source

Thrown at packages/core/src/video/OffthreadVideo.tsx:173

	preservePitch,
	showInTimeline,
	style,
	toneFrequency,
	toneMapped,
	transparent,
	trimAfter,
	trimBefore,
	useWebAudioApi,
	volume,
	_remotionInternalNativeLoopPassed,
	endAt,
	_remotionInternalStack,
	startFrom,
	imageFormat,
	...props
}) => {
	if (imageFormat) {
		throw new TypeError(
			`The \`<OffthreadVideo>\` tag does no longer accept \`imageFormat\`. Use the \`transparent\` prop if you want to render a transparent video.`,
		);
	}

	return (
		<InnerOffthreadVideo
			acceptableTimeShiftInSeconds={acceptableTimeShiftInSeconds}
			allowAmplificationDuringRender={allowAmplificationDuringRender ?? true}
			audioStreamIndex={audioStreamIndex ?? 0}
			crossOrigin={crossOrigin}
			delayRenderRetries={delayRenderRetries}
			delayRenderTimeoutInMilliseconds={delayRenderTimeoutInMilliseconds}
			loopVolumeCurveBehavior={loopVolumeCurveBehavior ?? 'repeat'}
			muted={muted ?? false}
			name={name}
			onAutoPlayError={onAutoPlayError ?? null}
			onError={onError}
			onVideoFrame={onVideoFrame}

View on GitHub (pinned to 78fe4bb3fd)

Solutions

1. Remove the `imageFormat` prop from `<OffthreadVideo>`.
2. Use the `transparent` prop instead: `transparent={true}` for transparent videos.
3. Run a repo-wide search for `imageFormat=` on `<OffthreadVideo>` usages.

Example fix

// before
<OffthreadVideo src={url} imageFormat="png" />
// after
<OffthreadVideo src={url} transparent />

// Codemod: remove imageFormat from <OffthreadVideo> and add transparent when needed

When it happens

Trigger: Passing `imageFormat="png"` or any value to `<OffthreadVideo>` after upgrading Remotion to a version that removed it.

Common situations: Upgrading Remotion across a major version and not migrating the API, or copy-pasting old example code.

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/d0b2b0a5ce7c1ea6. Report an issue: GitHub.