remotion-dev/remotion · error · Error

acceptableTimeShift has been removed. Use acceptableTimeShif

Error message

acceptableTimeShift has been removed. Use acceptableTimeShiftInSeconds instead.

What it means

The `acceptableTimeShift` prop (in seconds-implicit units) was renamed to `acceptableTimeShiftInSeconds` for clarity. `<Video>` (preview path) throws on first render if the old prop is present to force the migration.

Source

Thrown at packages/core/src/video/VideoForPreview.tsx:143

	const _propsValid: IsExact<typeof nativeProps, Expected> = true;

	if (!_propsValid) {
		throw new Error('typecheck error');
	}

	const volumePropFrame = useFrameForVolumeProp(
		loopVolumeCurveBehavior ?? 'repeat',
	);
	const {fps, durationInFrames} = useVideoConfig();
	const parentSequence = useContext(SequenceContext);
	const logLevel = useLogLevel();
	const mountTime = useMountTime();

	const [timelineId] = useState(() => String(Math.random()));

	if (typeof acceptableTimeShift !== 'undefined') {
		throw new Error(
			'acceptableTimeShift has been removed. Use acceptableTimeShiftInSeconds instead.',
		);
	}

	const [mediaVolume] = useMediaVolumeState();
	const [playerMuted] = usePlayerMutedState();

	const userPreferredVolume = evaluateVolume({
		frame: volumePropFrame,
		volume,
		mediaVolume,
	});

	warnAboutTooHighVolume(userPreferredVolume);

	const getStack = useCallback(() => {
		return _remotionInternalStack ?? null;
	}, [_remotionInternalStack]);

View on GitHub (pinned to 78fe4bb3fd)

Solutions

1. Rename the prop: `acceptableTimeShift` -> `acceptableTimeShiftInSeconds`.
2. Search the codebase for `acceptableTimeShift=` (without `InSeconds`) and update all sites.
3. Remove the prop if the default tolerance is acceptable.

Example fix

// before
<Video src={url} acceptableTimeShift={0.1} />
// after
<Video src={url} acceptableTimeShiftInSeconds={0.1} />

// Codemod rename: acceptableTimeShift -> acceptableTimeShiftInSeconds

When it happens

Trigger: Passing `acceptableTimeShift={...}` to `<Video>` or `<OffthreadVideo>` after upgrading Remotion.

Common situations: Upgrading Remotion across the version that renamed the prop, or using stale 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/51ad327185cba00f. Report an issue: GitHub.