remotion-dev/remotion · error · Error

Comma-separated frame selections are only supported by the l

Error message

Comma-separated frame selections are only supported by the local `remotion render` command. Pass one frame range to render a video on Cloud Run.

What it means

Thrown by the Cloud Run render CLI command when the user passes selected frames (--frames=0,10 or a multi-range) that are only supported by the local remotion render command. Cloud Run requires a single contiguous frame range.

Source

Thrown at packages/cloudrun/src/cli/commands/render/index.ts:108

	const imageFormat = BrowserSafeApis.options.videoImageFormatOption.getValue({
		commandLine: CliInternals.parsedCli,
	}).value;

	const audioCodec = BrowserSafeApis.options.audioCodecOption.getValue({
		commandLine: CliInternals.parsedCli,
	}).value;

	const {envVariables, frameRange, inputProps, selectedFrames} =
		CliInternals.getCliOptions({
			isStill: false,
			logLevel,
			indent: false,
		});
	if (
		selectedFrames !== null ||
		(Array.isArray(frameRange) && Array.isArray(frameRange[0]))
	) {
		throw new Error(
			'Comma-separated frame selections are only supported by the local `remotion render` command. Pass one frame range to render a video on Cloud Run.',
		);
	}

	const singleFrameRange = frameRange as SingleFrameRange | null;

	const height = overrideHeightOption.getValue({
		commandLine: CliInternals.parsedCli,
	}).value;
	const width = overrideWidthOption.getValue({
		commandLine: CliInternals.parsedCli,
	}).value;
	const fps = overrideFpsOption.getValue({
		commandLine: CliInternals.parsedCli,
	}).value;
	const durationInFrames = overrideDurationOption.getValue({
		commandLine: CliInternals.parsedCli,
	}).value;

View on GitHub (pinned to 78fe4bb3fd)

Solutions

Pass a single contiguous range: --frames=0-60 or --frames=30.
For multiple disjoint ranges, render locally with `remotion render` instead.
Run separate `remotion cloudrun render` invocations per range.

Example fix

# before
npx remotion cloudrun render MyComp --frames=0-10,20-30
# after
npx remotion cloudrun render MyComp --frames=0-30

Defensive patterns

Strategy: validation

Prevention

Use only single contiguous --frames values for the cloudrun render subcommand.
Reserve comma-separated frame selections for the local remotion render command.

When it happens

Trigger: Running `remotion cloudrun render` with --frames using comma-separated selections, or a multi-range value parsed into a nested array.

Common situations: Reusing the same --frames flag value from local rendering workflows on the cloudrun render subcommand.

Related errors

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