remotion-dev/remotion · error · TypeError

No `src` was passed to

Error message

No `src` was passed to <NewAudioForPreview>.

What it means

Thrown by <NewAudioForPreview> in @remotion/media when the `src` prop is falsy during Studio preview. The internal preview component needs a concrete URL to preload and play audio, so an empty/undefined source is a hard error rather than silent silence.

Solutions

1. Provide a non-empty string src: <Audio src={staticFile('audio.mp3')} />.
2. If audio is optional, conditionally render the component: {src && <Audio src={src} />}.
3. Verify the src variable is populated before the composition renders (check the prop value in Studio).

Example fix

// before
<Audio src={audioUrl} /> // audioUrl may be undefined during preview

// after
{audioUrl ? <Audio src={audioUrl} /> : null}

const audioSrc = typeof src === 'string' && src.length > 0 ? src : null;
return audioSrc ? <Audio src={audioSrc} /> : null;

const isNonEmptyString = (v: unknown): v is string =>
  typeof v === 'string' && v.trim().length > 0;

When it happens

Trigger: Rendering <Audio src={undefined} />, <Audio src={''} />, or <Audio src={null} /> inside a composition that runs in Remotion Studio preview. Typically the src is bound to a variable that is not yet populated (e.g. a staticFile path computed conditionally).

Common situations: Loading audio src from props that are optional and not yet set, building src from a template that yields empty string, or forgetting to call staticFile() on an asset that lives in public/.

Related errors

• No `src` was passed to
• The ` ` tag requires a string for `src`, but got instead.
• No audio track found
• No src passed
• No src passed

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

Appendix: source

Thrown at packages/media/src/audio/audio-for-preview.tsx:114

	const volumePropFrame = useFrameForVolumeProp(
		loopVolumeCurveBehavior ?? 'repeat',
	);

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

	warnAboutTooHighVolume(userPreferredVolume);

	if (!videoConfig) {
		throw new Error('No video config found');
	}

	if (!src) {
		throw new TypeError('No `src` was passed to <NewAudioForPreview>.');
	}

	const currentTime = frame / videoConfig.fps;

	const currentTimeRef = useRef(currentTime);
	currentTimeRef.current = currentTime;

	const preloadedSrc = usePreload(src);

	const parentSequence = useContext(SequenceContext);
	const isPremounting = Boolean(parentSequence?.premounting);
	const isPostmounting = Boolean(parentSequence?.postmounting);
	const sequenceOffset = (parentSequence?.absoluteFrom ?? 0) / videoConfig.fps;

	const {isMutedForPlayback: effectiveMuted} = useMediaAudioState({
		muted,
		volume: userPreferredVolume,
		audioEnabled: true,

View on GitHub (pinned to 46a3a6bf13)