How do I handle a validation error?

Last updated: May 7, 2026

A validation error is an error Zaymo surfaces when the current state of an email template will fail to render in Gmail. Zaymo warns you so you can take action before exporting the email.

What is the validation error

There is a red "Failed Validation" message that appears when Zaymo surfaces a validation error.

To get more information, click on the red Failed Validation warning message. It will say something like "This template is invalid. Try undoing your latest changes or reach out to support."

To see all the details, click on the View Detailed Errors accordion. You'll want to share the details in this dropdown with support if you reach out.

image.png

Most common reasons for validation errors

Product block missing selected product

Error message

Product block does not have a selected product. Please select a product and try again.

How to resolve

No need to reach out to support. Just add a product to the empty product block. How to choose products.

Template is too large

Error message

The template is too large. AMP emails must be less than 200kb. Please reduce the size of the template by removing unused blocks and try again.

How to resolve

No need to reach out to support. Gmail has a hard cap on how large the interactive AMP portion of the email can be (200kb). There is nothing you can change about that.

You can, however, follow Zaymo's best practices for minimizing interactive email size. How to minimize interactive email size.

Unsupported tags

Error message

Failed to process template. Please check for syntax errors or invalid expressions on the Klaviyo tags.

How to resolve

If you have intense Klaviyo tags built into the email, double-check the tags to make sure they are compliant. Make sure the email template rendered correctly before importing the template to Zaymo. Oftentimes, the issue Zaymo is detecting was already an issue in Klaviyo before the template was imported to Zaymo.

Missing URL for link elements

Error message

Missing URL for attribute href in tag a

How to resolve

This error occurs when an element has link formatting but no URL specified or is tied to an event. Follow these steps:

  1. Edit the flagged element:

    • For any button or text link, add a valid URL in the Link/URL (href) field

    • If it's meant to be non-clickable, remove the link formatting or delete the empty link

  2. Re‑validate by clicking Preview / Export

Common culprits include buttons without a URL, linked images with an empty link, or text that was highlighted and “linked” but left blank.

If you cannot identify the error, or fix the issue, message Zaymo support, and we will have an engineer find the unsupported tag in your email code and recommend a different way to do it.