Troubleshooting & FAQ
Designer
Section titled “Designer”My QR code won’t scan
Section titled “My QR code won’t scan”Most likely cause: The quiet zone (margin) is too small, especially on printed material.
Fix: Select the QR element → Design tab → set Quiet Zone to at least 4 modules, or click Print Safe (4 modules).
Also check that there is sufficient contrast between Dark Color and Light Color — avoid light-on-light or dark-on-dark combinations.
Text is cut off or shows ”…”
Section titled “Text is cut off or shows ”…””Cause: The text is longer than the element’s bounding box and the overflow mode is set to Clip or Ellipsis.
Fix: Select the text element → Typography tab. Either:
- Increase the element size (drag a corner handle).
- Enable Auto-Fit Text so the font shrinks to fit.
- Change Overflow to Visible to allow text to overflow the box.
My template says “Read only”
Section titled “My template says “Read only””Cause: You’re viewing a shared template that belongs to another user.
Fix: Click Use this template in the header. This creates your own editable copy in a project you own. See Reusing & Copying Templates.
I accidentally deleted an element
Section titled “I accidentally deleted an element”Fix: Press ⌘Z / Ctrl+Z to undo. Zandovi keeps up to 50 history steps. See Undo, Redo & History.
I can’t select an element on the canvas
Section titled “I can’t select an element on the canvas”Cause: The element may be locked.
Fix: Open the Layers panel (left sidebar) and click the lock icon on that layer row to unlock it, then select it on the canvas.
The Generate button is disabled
Section titled “The Generate button is disabled”Cause: Either no template is open, or the template has not been saved yet.
Fix: Make sure a template is open in the Designer and click Save (or press ⌘S) before generating.
Variables & Batch
Section titled “Variables & Batch”My batch job shows validation errors
Section titled “My batch job shows validation errors”Cause: One or more CSV rows have missing required values, or a barcode column contains data in the wrong format for the selected barcode type.
Fix: Open the error details (click View Errors), correct the flagged rows in your spreadsheet, re-upload, and re-submit.
Variable inputs don’t appear in the Generate dialog
Section titled “Variable inputs don’t appear in the Generate dialog”Cause: The template has no variable-bound elements.
Fix: Select an element → Design tab → toggle Use as variable to ON, configure a name in the Variable tab, and save the template. See Creating a Variable.
My default value doesn’t appear on the canvas
Section titled “My default value doesn’t appear on the canvas”Cause: The Use as variable toggle may be OFF for that element, so it’s not reading the default from the Variable tab.
Fix: Toggle Use as variable ON, then set the default in the Variable tab.
Account & Billing
Section titled “Account & Billing”I’m not receiving sign-in emails
Section titled “I’m not receiving sign-in emails”Check your spam/junk folder. The magic link expires in 15 minutes — if it has expired, go to the login page and click Resend link.
I can’t invite team members
Section titled “I can’t invite team members”Cause: Invitations require the Team plan and Admin or Owner role.
Fix: Upgrade to the Team plan via Settings → Billing → Change plan. See Choosing a Plan.
My API renders are returning 429 errors
Section titled “My API renders are returning 429 errors”Cause: You’ve reached your monthly API quota.
Fix: Wait for the quota to reset (check Settings → Billing for reset date), or upgrade to a plan with a higher quota. See Usage & Quotas.
I deleted an API key and now my integration is broken
Section titled “I deleted an API key and now my integration is broken”Deleted keys stop working immediately and cannot be recovered. Create a new key in Settings → API Keys, update your integration with the new key, and store it securely. See API Keys.
Still stuck?
Section titled “Still stuck?”If you can’t find an answer here, reach out via the support channel linked in your account or email the address on the Zandovi website.