Skip to main content

Frequently Asked Questions

Short answers with links to the canonical pages.

Project Configuration​

What video dimensions should I use?​

Use a resolution preset for standard social/HD formats (e.g. instagram-post, youtube-short, full-hd), or resolution: "custom" with explicit width/height for anything else. Output dimensions are limited by your plan.

What frame rate should I use?​

30 for most content, 60 for smoother motion (larger files), 24 for a cinematic look, 25 for PAL. The API accepts integers from 1 to 60.

Which output format should I choose?​

mp4 (recommended), webm, mov, or avi. For still images, see Rendering Images.

Elements​

How do I center elements?​

Set position: "center-center" — see Common Element Properties.

How do I size media?​

Provide width/height and optionally resize: contain keeps the full asset visible, cover fills the box and may crop.

How do timing properties work?​

enterBegin → enterEnd → exitBegin → exitEnd, in seconds. See Common Element Properties.

Why are animations not showing?​

The animation window has zero length, the effect name isn't a supported xfade name, or the timing is outside the project duration. See Animations.

Media Files​

What media formats are supported?​

Input assets are remote HTTP/HTTPS URLs; FFmpeg-compatible media generally works (JPEG/PNG/WebP images, MP4/MOV/WebM/MKV video, MP3/WAV/AAC/OGG/M4A audio), subject to plan limits. In the editor you can also upload files to your media library.

Are there hard limits?​

Yes — plan-dependent limits on duration, output/input resolution, media size, and element counts. Validation errors include your active limits. See Credits, Plans & Limits.

Audio​

What volume values are allowed?​

0 to 2, on both audio tracks and video elements. 0 mutes, 1 preserves the source level, and values above 1 amplify it; loud sources can clip.

Text and Fonts​

Why is my custom font not displaying?​

Use an exact Google Fonts family name (Poppins, Montserrat, Roboto, …) in style.fontFamily. See Text & HTML Elements.

Why is my HTML text rejected?​

TEXT.html accepts a safe HTML subset (div, span, p, strong, em, lists, …) — no script/style tags, event handlers, or external CSS URLs. Rich styling belongs in customCode.

Templates & Automation​

How do I render the same video with different data?​

Author a template with variables and render it with per-request values — or thousands at once with bulk rendering.

How do I get notified when a render finishes?​

Register a webhook or pass a per-request webhookUrl.

Editor​

Is editor JSON compatible with the API?​

The editor exports Zvid project JSON. Before submitting it, run free hosted validation with your API key: the hosted API checks your plan and applies stricter limits than some editor controls. See Rendering & export.

Getting Help​