Definition
Email JSON-LD structured data applies schema.org vocabulary within script tags in email HTML to help mailbox providers interpret and display email content in richer ways. Supported features include event details with add-to-calendar buttons, order summaries with package tracking information, flight check-in links, restaurant reservation details, and review prompts. JSON-LD enables these actions within the inbox interface without requiring the recipient to open the email.
Common Use Cases
- Order confirmation emails — tracking number, delivery estimate, order summary displayed in inbox
- Event confirmation emails — date, time, location with one-tap calendar add
- Flight reservation emails — check-in link, gate information, boarding pass
- Restaurant reservation emails — reservation details with modify or cancel options
- Review request emails — star rating selection without opening the email
Why It Matters
This matters because the choices you make here show up directly in your results. JSON-LD enables these actions within the inbox interface without requiring the recipient to open the email. When this is handled well it supports engagement, delivery, and the trust subscribers place in your brand; when it is neglected, the effects tend to show up in declining performance and harder-to-fix problems further down the line.
Best Practices
- Implement JSON-LD in email head as a script tag following schema.org vocabulary
- Test structured data rendering using Google's email markup testing tool
- Combine JSON-LD with plain HTML fallbacks for unsupported clients
- Keep JSON-LD concise and scoped to the email's primary purpose
- Monitor supported action types as mailbox provider capabilities evolve
Was this useful?
Related Glossary Terms
Accessible CTA (Email)
An accessible CTA is a button or link coded with sufficient colour contrast, visible focus states, descriptive screen-reader text, and a minimum touch target of 44×44 pixels.
Adaptive Design
Adaptive design in email uses predefined layouts that adjust to specific device or client widths, rather than fluidly resizing to every possible screen.
AMP for Email
AMP for Email is a technology that allows interactive, dynamic content to live inside an email message, enabling forms, carousels and live updates.
AMP for Email
AMP for Email is a Google-developed framework that allows email messages to include interactive elements like forms, carousels, accordions, and live content. It turns static emails into dynamic, interactive experiences directly inside the inbox.
Autoplay Video in Email
Autoplay video in email refers to the limited ability to play video content automatically when an email is opened, using specific client-supported techniques.
Dark Mode
Dark mode in email refers to how email clients render messages when the recipient has dark mode enabled. It affects colour display, image rendering, and readability. Designers use CSS media queries and hybrid coding techniques to control the dark mode appearance.
Frequently Asked Questions
Good practice here means handling Email JSON-LD Structured Data in a way that is relevant, timely, and honest for your audience. Using JSON-LD markup within email HTML to provide machine-readable context that enables enhanced inbox features across supported email clients. Done well, it improves engagement and builds trust; done poorly, it creates friction that costs you results.
Because it touches the parts of email that drive outcomes: relevance, trust, and delivery. Small improvements compound, while repeated mistakes quietly erode the health of your programme.
The most common problems are treating Email JSON-LD Structured Data as a one-off task, ignoring what the data says, and copying competitors without testing. All three lead to effort that does not translate into better results.
Compare the metrics it should influence — engagement, conversions, and deliverability — before and after you make changes. Trends over time matter far more than any single send.
It supports the same goal as the rest of your email programme: the right message to the right person at the right time. Aligned with segmentation and automation, it reinforces everything else rather than competing with it.