Preferred effect backendv4.0.540

Prefer webgpu, webgl2, or 2d implementations of effects. Default: auto, which tries WebGPU, WebGL2, then 2D. Falls back when an implementation or backend is unavailable. Lambda selects WebGL2 or 2D implementations. Rendering fails if an effect has no supported implementation. This option also applies to Studio preview.

CLI flag

--preferred-effect-backend <value>

The following CLI commands accept this option:

• remotion studio
• remotion render
• remotion still
• remotion compositions
• remotion benchmark
• remotion lambda render
• remotion lambda still
• remotion lambda compositions
• remotion cloudrun render
• remotion cloudrun still

APIs that have this option

The following APIs accept this option:

• renderMediaOnCloudrun()
• renderStillOnCloudrun()
• getCompositionsOnLambda()
• renderMediaOnLambda()
• renderStillOnLambda()
• getCompositions()
• renderFrames()
• renderMedia()
• renderStill()
• selectComposition()
• renderMediaOnVercel()
• renderStillOnVercel()
• renderMediaOnWeb()
• renderStillOnWeb()

Config file

remotion.config.ts
Config.setPreferredEffectBackend('webgl2');

See also

• All options