Definition
JSON-LD for email applies structured data markup — the same JSON-LD format used for schema.org on websites — within email HTML to help mailbox providers interpret and surface email content in richer ways. Supported actions include displaying event details with add-to-calendar buttons, showing order summaries with package tracking information, surfacing flight check-in links, displaying restaurant reservation details, and presenting review or survey options directly within the inbox interface.
Capabilities
- Event emails: Mailbox can display date, time, and location with one-tap calendar add
- Order emails: Tracking information and order summary shown directly in inbox
- Flight emails: Check-in links, gate changes, and boarding pass access in preview
- Restaurant emails: Reservation details with modify or cancel options
- Review 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. HTML to help mailbox providers interpret and surface email content in richer ways. 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 the email head as a script tag following schema.org vocabulary
- Test structured data rendering using Google's email markup testing tool before sending
- Combine JSON-LD with plain HTML fallbacks for mailbox providers that do not support structured data
- 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 for Email in a way that is relevant, timely, and honest for your audience. Using structured data markup within email HTML to provide machine-readable context about the email content to mailboxes and applications. 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 for Email 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.