Complete Guide to Email Markup Structured Data Options + JSON-LD Examples

Table of Contents

Email Markup Structured Data Options: Complete Guide, Benefits, and JSON-LD Examples

Email communication has evolved significantly, especially for businesses relying on user interaction, order processing, appointments, deliveries, events, reviews, and customer engagement. Today, there’s more pressure than ever to make emails actionable, smart, and user-friendly. One of the most powerful technologies enabling this transformation is Email Markup Structured Data.

With email markup, your emails can display:

Rich cards
Smart actions
Visible buttons
Order summaries
Review interfaces
Reservation info
Shipment tracking previews

These enhancements turn ordinary emails into interactive experiences — all inside the user’s inbox.

What Is Email Markup Structured Data?

Email Markup is a structured data format — usually in JSON-LD — that helps email clients like Gmail understand the context, purpose, and action inside an email.

Just like Schema Markup improves website SEO, Email Schema Markup improves email experience.

When you embed structured data inside an email, Gmail can automatically display:

Action buttons
Information cards
Quick response options
Order summaries Email Schema Markup
Booking confirmations Email Schema Markup
Shipment tracking Email Schema Markup
Calendar events
Tickets Email Schema Markup
Review prompts Email Schema Markup

These enhancements reduce friction for users by enabling actions directly from the inbox — without opening a website.

Why Email Markup Was Introduced

Traditionally, completing an action from an email required multiple steps:

Open email
Read content
Find correct link
Click
Visit website
Login
Complete action

This led to user drop-offs and lower conversions.

Google introduced email markup to replace this multi-step flow with a one-tap experience.

Examples:

Confirm Registration button inside the inbox
Add to Calendar card for events
Track Order panel for deliveries
Review Product action without visiting the website

The result?

Better user experience and higher engagement.

Which Businesses Should Use Email Markup?

Email Markup is valuable for:

E-commerce stores
Travel platforms
Airlines
Hotels & resorts
Hospitals & clinics
Event organizers
SaaS companies
Delivery services
Food ordering apps
Cab pickup apps
Subscription businesses
Online education portals
Real estate booking platforms

Essentially, any business sending transactional or action-based emails should use it.

Types of Email Markup Structured Data (With JSON-LD Examples)

Below is the most comprehensive list of email markup examples you will find online — all in JSON-LD format.

1. ONE-CLICK ACTION MARKUP

These actions let users complete tasks instantly.

1.1 Email Verification Action

Use Case: User signs up -> Gmail shows a button -> Verify Email

JSON-LD Example


<script type="application/ld+json">
{
  "@context": "http://schema.org",
  "@type": "EmailMessage",
  "description": "Click the button below to verify your email address.",
  "action": {
    "@type": "ConfirmAction",
    "name": "Verify Email",
    "handler": {
      "@type": "HttpActionHandler",
      "url": "https://yourdomain.com/verify?token=12345"
    }
  }
}
</script>

1.2 Reset Password Action


<script type="application/ld+json">
{
  "@context": "http://schema.org",
  "@type": "EmailMessage",
  "description": "Reset your password by clicking the button below.",
  "action": {
    "@type": "ConfirmAction",
    "name": "Reset Password",
    "handler": {
      "@type": "HttpActionHandler",
      "url": "https://yourdomain.com/reset-password?token=abc123"
    }
  }
}
</script>

1.3 Approve or Reject Action

Useful for:

Requests
Approvals
Access management


<script type="application/ld+json">
{
  "@context": "http://schema.org",
  "@type": "EmailMessage",
  "description": "Reset your password by clicking the button below.",
  "action": {
    "@type": "ConfirmAction",
    "name": "Reset Password",
    "handler": {
      "@type": "HttpActionHandler",
      "url": "https://yourdomain.com/reset-password?token=abc123"
    }
  }
}
</script>

You can add a reject action using DisagreeAction.

2. VIEW ACTION / BUTTON ACTION

Allows users to open important pages.

2.1 Track Order Button


<script type="application/ld+json">
{
  "@context": "http://schema.org",
  "@type": "EmailMessage",
  "action": {
    "@type": "ViewAction",
    "name": "Track Your Order",
    "url": "https://yourdomain.com/order/track/12345"
  }
}
</script>

2.2 View Invoice


<script type="application/ld+json">
{
  "@context": "http://schema.org",
  "@type": "EmailMessage",
  "action": {
    "@type": "ViewAction",
    "name": "View Invoice",
    "url": "https://yourdomain.com/invoice/56789"
  }
}
</script>

3. RSVP ACTION MARKUP

Shows Yes/No/Maybe buttons inside the inbox.

3.1 Event RSVP Example

<script type="application/ld+json">
{
  "@context": "http://schema.org",
  "@type": "EventReservation",
  "reservationStatus": "http://schema.org/ReservationConfirmed",
  "reservationId": "ABC123",
  "underName": {
    "@type": "Person",
    "name": "Hemant Sharma"
  },
  "reservationFor": {
    "@type": "Event",
    "name": "Online Webinar",
    "startDate": "2025-11-10T10:00:00+05:30"
  },
  "potentialAction": {
    "@type": "RsvpAction",
    "target": "https://vbagetech.com/rsvp",
    "name": "RSVP Now"
  }
}
</script>

4. REVIEW ACTION MARKUP

Used by e-commerce, delivery apps, and service businesses.

4.1 Product Review Prompt

<script type="application/ld+json">
{
  "@context": "http://schema.org",
  "@type": "ReviewAction",
  "name": "Rate Your Order",
  "target": "https://yourdomain.com/review/order/1234"
}
</script>

5. ORDER & DELIVERY MARKUP

Automatically organizes your receipts in Gmail.

5.1 Order Confirmation

<script type="application/ld+json">
{
  "@context": "http://schema.org",
  "@type": "Order",
  "merchant": {
    "@type": "Organization",
    "name": "Your Store"
  },
  "orderNumber": "12345",
  "orderStatus": "OrderProcessing",
  "priceCurrency": "INR",
  "price": "1999",
  "acceptedOffer": [{
    "@type": "Offer",
    "itemOffered": {
      "@type": "Product",
      "name": "Wireless Earbuds"
    },
    "price": "1999"
  }]
}
</script>

5.2 Parcel Delivery Tracking

<script type="application/ld+json">
{
  "@context": "http://schema.org",
  "@type": "ParcelDelivery",
  "trackingNumber": "TRACK1234",
  "carrier": {
    "@type": "Organization",
    "name": "Delhivery"
  },
  "deliveryStatus": "InTransit",
  "expectedArrivalUntil": "2025-02-05T18:00:00+05:30"
}
</script>

6. RESERVATION / BOOKING MARKUP

Automatically organizes your booking or reservation in Gmail.

6.1 Hotel Reservation

<script type="application/ld+json">
{
  "@context": "http://schema.org",
  "@type": "LodgingReservation",
  "reservationId": "HOTEL123",
  "reservationStatus": "ReservationConfirmed",
  "underName": {
    "@type": "Person",
    "name": "Rahul Kumar"
  },
  "reservationFor": {
    "@type": "LodgingBusiness",
    "name": "Sunrise Resort"
  },
  "checkinDate": "2025-12-10",
  "checkoutDate": "2025-12-15"
}
</script>

7. TRAVEL & TICKET MARKUP

Airlines and travel apps use this heavily.

7.1 Flight Ticket Example

<script type="application/ld+json">
{
  "@context": "http://schema.org",
  "@type": "FlightReservation",
  "reservationId": "FLY123",
  "reservationStatus": "ReservationConfirmed",
  "underName": { "@type": "Person", "name": "Anita Singh" },
  "reservationFor": {
    "@type": "Flight",
    "flightNumber": "AI202",
    "airline": { "@type": "Airline", "name": "Air India" },
    "departureAirport": { "@type": "Airport", "name": "Delhi Airport" },
    "arrivalAirport": { "@type": "Airport", "name": "Mumbai Airport" },
    "departureTime": "2025-06-18T14:00:00+05:30"
  }
}
</script>

8. EVENT MARKUP (CALENDAR)

Organizes your calendar events in Gmail.

8.1 Add Event to Calendar

<script type="application/ld+json">
{
  "@context": "http://schema.org",
  "@type": "Event",
  "name": "Digital Marketing Workshop",
  "startDate": "2025-05-20T11:00:00+05:30",
  "endDate": "2025-05-20T13:00:00+05:30",
  "location": "Online"
}
</script>

9. PROMOTIONS MARKUP

This enhances your email in the promotions tab.

9.1 Promo Card

<script type="application/ld+json">
{
  "@context": "http://schema.org",
  "@type": "PromotionCard",
  "image": "https://yourdomain.com/promo.jpg",
  "title": "Flat 40% OFF",
  "description": "Limited-time deal on electronics",
  "url": "https://yourdomain.com/offers"
}
</script>

10. INVOICE MARKUP

This enhances your email in the promotions tab.

10.1 Invoice Example

<script type="application/ld+json">
{
  "@context": "http://schema.org",
  "@type": "Invoice",
  "paymentStatus": "PaymentComplete",
  "totalPaymentDue": {
    "@type": "MonetaryAmount",
    "currency": "INR",
    "value": "4500"
  },
  "provider": {
    "@type": "Organization",
    "name": "Your Company"
  }
}
</script>

11. APPOINTMENT MARKUP

11.1 Appointment Confirmation

<script type="application/ld+json">
{
  "@context": "http://schema.org",
  "@type": "Appointment",
  "provider": {
    "@type": "MedicalBusiness",
    "name": "HealthCare Clinic"
  },
  "startDate": "2025-04-15T12:00:00+05:30",
  "name": "Doctor Consultation"
}
</script>

Best Practices for Email Markup

Use JSON-LD — preferred by Gmail
Authenticate domain (SPF, DKIM, DMARC)
Use HTTPS only
Validate markup with Google’s Email Markup Tester
Maintain consistent styling and structure
Use rich snippets only in transactional emails
Ensure links are stable and not time-limited
Avoid spammy content

Email markup structured data is not just a modern trend — it’s a powerful transformation tool for business communication. By enabling rich cards, action buttons, bookings, tickets, events, and order summaries inside the inbox, you empower users to act faster and engage more effectively.

Businesses that adopt email markup stand out with:

Higher engagement
Better customer experience
Faster user actions
Professional email presence
Reduced drop-offs

It’s time to upgrade your emails to the next level of intelligence.

Email Markup Structured Data