Troubleshooting renders

Most render problems come down to one of a few causes. Here are the common ones and how to fix each.

Text overflows or gets cut offText overflows or gets cut off

Your text is longer than the space you designed for. Design the text component for the longest realistic value, turn on auto-fit or wrapping, or shorten the input. Remember that fixed dimensions never reflow, so the layout stays pixel-perfect and long text needs room.

The wrong font shows upThe wrong font shows up

The font isn't available at render time. Use a font from the font list, or upload your custom font first so the renderer can embed it.

An image field renders blankAn image field renders blank

The image URL couldn't be loaded. Check that the URL is public, reachable, and points directly at an image file. A link behind a login or a redirect won't load.

A dynamic field isnt applyingA dynamic field isn't applying

The field name in your request doesn't match the template. Field names are case-sensitive, so title and Title are different. Confirm the exact name in the editor and match it exactly.

401 unauthorized401 Unauthorized

Your API key is missing or wrong. Copy a fresh key from your dashboard and send it in the dma-api-key header on your render request.

429 quota exceeded429 Quota exceeded

You've used your render allowance for the period. Wait for the reset or upgrade on the pricing page. See how pricing and quota work for the details.

The output format or quality isnt what i expectedThe output format or quality isn't what I expected

The render defaults to JPEG. Add ?format=png|jpeg|webp|pdf to choose the output. See output formats. A few things to know:

• ?quality= only affects JPEG. For PNG, WebP, and PDF it is ignored, since those formats use their own lossless or default encoding. If you need a smaller file, switch to JPEG and lower the quality.
• Transparency needs PNG or WebP. JPEG has no alpha channel, so a transparent background renders as white. Use ?format=png (or webp) to keep it transparent.
• PDF is single-page and print-ready. It's the design at its full dimensions on one page, not a multi-page document.

Still stuckStill stuck?

If a render still fails after these checks, reach out and include the design ID and the exact request you sent. That's usually enough to spot the cause fast.

Frequently asked questionsFrequently asked questions

Why does my text look different from the editorWhy does my text look different from the editor?

Almost always a font issue. Make sure the font is on the font list or uploaded as a custom font so the renderer can use it.

Why is my image not showing in the renderWhy is my image not showing in the render?

The image URL isn't publicly reachable. Open it in a private browser window. If it needs a login or redirects, the renderer can't load it.

My api call returns 401 whats wrongMy API call returns 401. What's wrong?

The API key is missing or invalid. Generate a new key in your dashboard and pass it in the dma-api-key header on your render request.