Validate AMP Emails
Important: this documentation is not applicable to your currently selected format stories!
AMP Emails depend on the AMP JS library to enable rich interactive and dynamic experiences for readers. For this reason, email providers require your messages to be validated. Valid AMP markup guarantees emails are safe and exceed user experience standards.
How do I check if my email is valid AMP?
There are several ways available to validate an email as a valid AMP Email. They will all produce the exact same result, so choose whichever one suits your development style the most!
The AMP web-based validator supports the AMP for Email platform. Use the web-based validator by pasting your AMP Email into the tool. It will flag any validator errors directly inline.
You can validate AMP Emails files by using the AMP HTML validator command line tool.
- Make sure you have Node.js with its package manager 'npm' on your system.
- Install the AMP HTML validator command line tool by running the following command:
npm install -g amphtml-validator.
After installing the command-line tool, run the following command after replacing
<amphtml file> with your file containing the AMP Email content.
amphtml-validator --html_format AMP4EMAIL <amphtml file>
If the email is valid the command-line tool will result in a
PASS. If invalid, it will return with the errors it found.
You can also validate AMP Emails using the AMP playground. Similar to the web-based validator, paste your AMP Email into the tool, and the playground will flag any validator errors directly inline.
Validate delivered emails
Sometimes your delivered AMP Emails may be invalid even though the email markup you authored has already been validated by tools documented in this page. The most common reason for this to happen is that your ESP modified your email markup and made it invalid after you have sent your email to your ESP for delivery. For example, if your ESP is SparkPost and you haven't configured HTTPS tracking pixels with SparkPost, then SparkPost will add an insecure HTTP tracking pixel to your email. Since AMP Emails only allow HTTPS images, this will make your AMP Email invalid.
To check whether an email delivered to your inbox is valid AMP:
- download the AMP Email as an
.emlfile from your email client.
- Open the AMP playground.
- Click on "IMPORT EMAIL", and select the
.emlfile you just downloaded.
The playground will import the AMP email you downloaded into the inline editor and flag any validation errors.
What happens if my email isn't valid?
The AMP Validator isn't just a convenience for you during development, email providers supporting AMP Emails will automatically fallback to the provided HTML or Plain Text MIME types. An AMP Email should only be sent if it passes the validator.
Written by @CrystalOnScript