Companies selling plane tickets

Your emails to customers can be presented in a special way in the list of incoming messages. To do that, include booking or ticket information in the email using Schema.org markup.

How to mark up emails

To mark up your emails:

  1. Take into account the Yandex requirements for mail-outs. Make sure that the domain you want to send the emails from complies with the requirements.
  2. Use the FlightReservation type of the Schema.org standard supported by Yandex Mail and one of two data description formats: Microdata or JSON-LD.
  3. Validate your markup.

If you did everything listed above but your markup doesn't work, fill out the form at the bottom of the page:

  1. Select "Widgets (highlighting emails in the email list)".
  2. In your message, specify the domain you want to send emails from.
  3. Wait for a response from the support team.

Examples of markup

You can use the validated examples to mark up your emails:

  • JSON-LD example markup should be pasted into the head element of the email's HTML code.

  • Microdata should be added as extra attributes for elements in the email's HTML code.

Confirmation of ticket purchase

An email confirming the purchase of a ticket usually contains an itinerary receipt.

JSON-LD
<script type="application/ld+json">
{  
  "@context": "http://schema.org",  
  "@type": "FlightReservation",  
  "reservationId": "RXJ34P",  
  "reservationStatus": "http://schema.org/Confirmed",  
  "reservationFor": 
  {    
    "@type": "Flight",    
    "flightNumber": "110",    
    "provider":     
    {            
     "@type": "Airline",            
     "name": "Aeroflot",            
     "iataCode": "SU"        
    },       
    "departureAirport": 
    {      
      "@type": "Airport",      
      "name": "Domodedovo",      
      "iataCode": "DME"    
    },    
    "departureTime": "2017-03-04T20:15:00-08:00",    
    "arrivalAirport": 
    {      
      "@type": "Airport",      
      "name": "Simferopol",      
      "iataCode": "SIP"    
    },    
    "arrivalTime": "2017-03-05T06:30:00-05:00"  
  }
}
</script>
Microdata
<div itemscope itemtype="http://schema.org/FlightReservation">  
  <meta itemprop="reservationId" content="RXJ34P"/>  
  <link itemprop="reservationStatus" href="http://schema.org/Confirmed"/>
  <div itemprop="reservationFor" itemscope itemtype="http://schema.org/Flight">    
    <meta itemprop="flightNumber" content="110"/>    
    <div itemprop="provider" itemscope itemtype="http://schema.org/Airline">      
      <meta itemprop="name" content="Aeroflot"/>      
      <meta itemprop="iataCode" content="SU"/>    
    </div>    
    <div itemprop="departureAirport" itemscope itemtype="http://schema.org/Airport">      
      <meta itemprop="name" content="Domodedovo"/>      
      <meta itemprop="iataCode" content="DME"/>    
    </div>    
    <meta itemprop="departureTime" content="2017-03-04T20:15:00-08:00"/>    
    <div itemprop="arrivalAirport" itemscope itemtype="http://schema.org/Airport">      
      <meta itemprop="name" content="Simferopol"/>      
      <meta itemprop="iataCode" content="SIP"/>    
    </div>    
    <meta itemprop="arrivalTime" content="2017-03-05T06:30:00-05:00"/>  
  </div>
</div>

Boarding pass

You can add information about the boarding pass to the confirmation of ticket purchase.

JSON-LD
<script type="application/ld+json">
{    
  "@context": "http://schema.org",    
  "@type": "FlightReservation",    
  "reservationId": "RXJ34P",    
  "reservationStatus": "http://schema.org/Confirmed", 
  "reservationFor":   
  {        
    "@type": "Flight",        
    "flightNumber": "110",        
    "provider":     
    {            
      "@type": "Airline",            
      "name": "Aeroflot",            
      "iataCode": "SU"        
    },            
    "departureAirport":     
    {            
      "@type": "Airport",            
      "name": "Domodedovo",            
      "iataCode": "DME"        
    },        
    "departureTime": "2017-03-04T20:15:00-08:00",        
    "arrivalAirport":     
    {            
      "@type": "Airport",            
      "name": "Simferopol",            
      "iataCode": "SIP"        
    },        
    "arrivalTime": "2017-03-05T06:30:00-05:00"    
  }, 
  "reservedTicket": 
  {    
    "@type": "Ticket",    
    "ticketNumber": "ABC1234",    
    "ticketToken": "qrCode:AB34",    
    "ticketedSeat": 
    {      
      "@type": "Seat",      
      "seatRow": "A",      
      "seatNumber": "9",      
      "seatSection": "101"   
    }  
  }   
}
</script>
Microdata
<div itemscope itemtype="http://schema.org/FlightReservation">
  <meta itemprop="reservationId" content="RXJ34P"/>
  <link itemprop="reservationStatus" href="http://schema.org/Confirmed"/>
  <div itemprop="reservationFor" itemscope itemtype="http://schema.org/Flight">
    <meta itemprop="flightNumber" content="110"/>
    <div itemprop="provider" itemscope itemtype="http://schema.org/Airline">
      <meta itemprop="name" content="Aeroflot"/>
      <meta itemprop="iataCode" content="SU"/>
    </div>
    <div itemprop="departureAirport" itemscope itemtype="http://schema.org/Airport">
      <meta itemprop="name" content="Domodedovo"/>
      <meta itemprop="iataCode" content="DME"/>
    </div>
    <meta itemprop="departureTime" content="2017-03-04T20:15:00-08:00"/>
    <div itemprop="arrivalAirport" itemscope itemtype="http://schema.org/Airport">
      <meta itemprop="name" content="Simferopol"/>
      <meta itemprop="iataCode" content="SIP"/>
    </div>
    <meta itemprop="arrivalTime" content="2017-03-05T06:30:00-05:00"/>
  </div>
  <div itemprop="reservedTicket" itemscope itemtype="http://schema.org/Ticket">
    <span itemprop="ticketNumber">ABC1234</span>
    <meta itemprop="ticketToken" content="qrCode:AB34">  
    <div itemprop="ticketedSeat"  itemscope itemtype="http://schema.org/Seat">
      <span itemprop="seatRow">A</span>
      <span ipemprop="seatNumber">9</span>
    </div>
  </div>
</div>

Changes in the schedule

For emails providing updated flight information, you can mark up the new details and the time they were last checked.

JSON-LD
<script type="application/ld+json">
{  
  "@context": "http://schema.org",  
  "@type": "FlightReservation",  
  "reservationId": "RXJ34P",  
  "reservationStatus": "http://schema.org/Confirmed",
  "reservationFor": 
  {    
    "@type": "Flight",    
    "flightNumber": "110",
    "provider":     
    {            
      "@type": "Airline",            
      "name": "Aeroflot",            
      "iataCode": "SU"        
    },        
    "departureAirport": 
    {      
      "@type": "Airport",      
      "name": "Domodedovo",      
      "iataCode": "DME"    
    },    
    "departureTime": "2017-03-04T20:15:00-08:00",    
    "arrivalAirport": 
    {      
      "@type": "Airport",      
      "name": "Simferopol",      
      "iataCode": "SIP"    
    },    
    "arrivalTime": "2017-03-05T06:30:00-05:00"  
  },  
  "modifiedTime": "2013-05-01T08:30:00-08:00"
}
</script>
Microdata
<div itemscope itemtype="http://schema.org/FlightReservation">  
  <meta itemprop="reservationId" content="RXJ34P"/>  
  <link itemprop="reservationStatus" href="http://schema.org/Confirmed"/>
  <div itemprop="reservationFor" itemscope itemtype="http://schema.org/Flight">    
    <meta itemprop="flightNumber" content="110"/>    
    <div itemprop="provider" itemscope itemtype="http://schema.org/Airline">      
      <meta itemprop="name" content="Aeroflot"/>      
      <meta itemprop="iataCode" content="SU"/>    
    </div>    
    <div itemprop="departureAirport" itemscope itemtype="http://schema.org/Airport">      
      <meta itemprop="name" content="Domodedovo"/>      
      <meta itemprop="iataCode" content="DME"/>    
    </div>    
    <meta itemprop="departureTime" content="2017-03-04T20:15:00-08:00"/>    
    <div itemprop="arrivalAirport" itemscope itemtype="http://schema.org/Airport">      
      <meta itemprop="name" content="Simferopol"/>      
      <meta itemprop="iataCode" content="SIP"/>    
    </div>    
    <meta itemprop="arrivalTime" content="2017-03-05T06:30:00-05:00"/>  
  </div>  
  <meta itemprop="modifiedTime" content="2013-05-01T08:30:00-08:00"/>
</div>

Flight cancellation

To notify a customer of their flight being canceled, include the reservationStatus property in your email markup and set its value to http://schema.org/Cancelled.

JSON-LD
<script type="application/ld+json">
{  
  "@context": "http://schema.org",  
  "@type": "FlightReservation",  
  "reservationId": "RXJ34P",  
  "reservationStatus": "http://schema.org/Cancelled", 
  "reservationFor": 
  {    
    "@type": "Flight",    
    "flightNumber": "110",    
    "provider":     
    {            
      "@type": "Airline",            
      "name": "Aeroflot",            
      "iataCode": "SU"        
    },        
    "departureAirport": 
    {      
      "@type": "Airport",      
      "name": "Domodedovo",      
      "iataCode": "DME"    
    },    
    "departureTime": "2017-03-04T20:15:00-08:00",    
    "arrivalAirport": 
    {      
      "@type": "Airport",      
      "name": "Simferopol",      
      "iataCode": "SIP"    
    },    
    "arrivalTime": "2017-03-05T06:30:00-05:00"  
  }
}
</script>
Microdata
<div itemscope itemtype="http://schema.org/FlightReservation">  
  <meta itemprop="reservationId" content="RXJ34P"/>  
  <link itemprop="reservationStatus" href="http://schema.org/Cancelled"/>
  <div itemprop="reservationFor" itemscope itemtype="http://schema.org/Flight">    
    <meta itemprop="flightNumber" content="110"/>    
    <div itemprop="provider" itemscope itemtype="http://schema.org/Airline">      
      <meta itemprop="name" content="Aeroflot"/>      
      <meta itemprop="iataCode" content="SU"/>    
    </div>    
    <div itemprop="departureAirport" itemscope itemtype="http://schema.org/Airport">      
      <meta itemprop="name" content="Domodedovo"/>      
      <meta itemprop="iataCode" content="DME"/>    
    </div>    
    <meta itemprop="departureTime" content="2017-03-04T20:15:00-08:00"/>    
    <div itemprop="arrivalAirport" itemscope itemtype="http://schema.org/Airport">      
      <meta itemprop="name" content="Simferopol"/>      
      <meta itemprop="iataCode" content="SIP"/>    
    </div>    
    <meta itemprop="arrivalTime" content="2017-03-05T06:30:00-05:00"/>  
  </div>
</div>

A flight with multiple legs

Describe each flight leg in a separate element of the FlightReservation type.

JSON-LD
<script type="application/ld+json">
[  
  {    
    "@context": "http://schema.org",    
    "@type": "FlightReservation",    
    "reservationId": "RXJ34P",    
    "reservationStatus": "http://schema.org/Confirmed", 
    "reservationFor": 
    {      
      "@type": "Flight",      
      "flightNumber": "201",      
      "provider":     
      {            
        "@type": "Airline",            
        "name": "Aeroflot",            
        "iataCode": "SU"        
      },          
      "departureAirport": 
      {        
        "@type": "Airport",        
        "name": "Domodedovo",        
        "iataCode": "DME"      
      },      
      "departureTime": "2017-03-04T11:00:00-05:00",      
      "arrivalAirport": 
      {        
        "@type": "Airport",        
        "name": "Simferopol",        
        "iataCode": "SIP"      
      },      
      "arrivalTime": "2017-03-05T13:25:00-06:00"    
    }  
  },  
  {    
    "@context": "http://schema.org",    
    "@type": "FlightReservation",    
    "reservationId": "RXJ34P",    
    "reservationStatus": "http://schema.org/Confirmed",    
    "reservationFor": 
    {      
      "@type": "Flight",      
      "flightNumber": "1050",      
      "provider":     
      {            
        "@type": "Airline",            
        "name": "Aeroflot",            
        "iataCode": "SU"        
      },          
      "departureAirport": 
      {        
        "@type": "Airport",        
        "name": "Domodedovo",        
        "iataCode": "DME"      
      },      
      "departureTime": "2017-03-05T14:55:00-06:00",      
      "arrivalAirport": 
      {        
        "@type": "Airport",        
        "name": "Simferopol",        
        "iataCode": "SIP"      
      },      
      "arrivalTime": "2017-03-05T15:15:00-08:00"    
    }  
  }
]
</script>
Microdata
<div itemscope itemtype="http://schema.org/FlightReservation">  
  <meta itemprop="reservationId" content="RXJ34P"/>  
  <link itemprop="reservationStatus" href="http://schema.org/Confirmed"/>
  <div itemprop="reservationFor" itemscope itemtype="http://schema.org/Flight">    
    <meta itemprop="flightNumber" content="201"/>    
    <div itemprop="provider" itemscope itemtype="http://schema.org/Airline">      
      <meta itemprop="name" content="Aeroflot"/>      
      <meta itemprop="iataCode" content="SU"/>    
    </div>    
    <div itemprop="departureAirport" itemscope itemtype="http://schema.org/Airport">      
      <meta itemprop="name" content="Domodedovo"/>      
      <meta itemprop="iataCode" content="DME"/>    
    </div>    
    <meta itemprop="departureTime" content="2017-03-04T11:00:00-05:00"/>    
    <div itemprop="arrivalAirport" itemscope itemtype="http://schema.org/Airport">      
      <meta itemprop="name" content="Simferopol"/>      
      <meta itemprop="iataCode" content="SIP"/>    
    </div>    
    <meta itemprop="arrivalTime" content="2017-03-05T13:25:00-06:00"/>  
  </div>
</div>
<div itemscope itemtype="http://schema.org/FlightReservation">  
  <meta itemprop="reservationId" content="RXJ34P"/>  
  <link itemprop="reservationStatus" href="http://schema.org/Confirmed"/>  
  <div itemprop="reservationFor" itemscope itemtype="http://schema.org/Flight">    
    <meta itemprop="flightNumber" content="1050"/>    
    <div itemprop="provider" itemscope itemtype="http://schema.org/Airline">      
      <meta itemprop="name" content="Aeroflot"/>      
      <meta itemprop="iataCode" content="SU"/>    
    </div>    
    <div itemprop="departureAirport" itemscope itemtype="http://schema.org/Airport">      
      <meta itemprop="name" content="Domodedovo"/>      
      <meta itemprop="iataCode" content="DME"/>    
    </div>    
    <meta itemprop="departureTime" content="2017-03-05T14:55:00-06:00"/>    
    <div itemprop="arrivalAirport" itemscope itemtype="http://schema.org/Airport">      
      <meta itemprop="name" content="Simferopol"/>      
      <meta itemprop="iataCode" content="SIP"/>    
    </div>    
    <meta itemprop="arrivalTime" content="2017-03-05T15:15:00-08:00"/>  
  </div>
</div>

The properties of the FlightReservation type supported by Yandex Mail

Property

Type

Description

Required

reservationId

Text

The booking number.

reservationStatus

ReservationStatus

Reservation status.
Possible values

reservationFor

Flight

Information about the flight that the passenger booked a ticket for.

reservationFor.arrivalAirport

Airport

Information about the destination airport.

This field can also have a value of the Text type, such as "Domodedovo".

reservationFor.arrivalAirport.iataCode

Text

The destination airport's IATA code, such as "DME".

reservationFor.arrivalAirport.name

Text

The destination airport's name.

reservationFor.arrivalTime

DateTime

The time of arrival at the destination airport.

reservationFor.departureAirport

Airport

Information about the departure airport.

This field can also have a value of the Text type, such as "Domodedovo".

reservationFor.departureAirport.iataCode

Text

The departure airport's IATA code, such as "DME".

reservationFor.departureAirport.name

Text

The departure airport's name.

reservationFor.departureTime

DateTime

The departure time.

reservationFor.flightNumber

Text

The flight number.

Optional

additionalTicketText

Text

Additional information about the boarding pass.

boardingGroup

Text

Airline-specific information about boarding.

bookingAgent

Organization or Person

Information about the agent booking the ticket.

bookingAgent.name

Text

The name of the agent booking the ticket.

bookingAgent.url

URL

The site address of the agent booking the ticket.

bookingTime

DateTime

The time of booking.

modifiedTime

DateTime

The time when the flight details were last updated.

potentialAction

ConfirmAction, CancelAction, or CheckInAction

Potential actions affecting the booking, such as confirmation, cancellation, or check-in.

potentialAction.target

EntryPoint

The pointer to a booking-related action (typically a link to the site).

reservationFor.provider

Airline

Information about the airline operating the flight.

reservationFor.provider.name

Text

The airline name.

reservationFor.provider.iataCode

Text

The airline's IATA code.

reservationFor.arrivalGate

Text

The gate number at the arrival airport.

reservationFor.arrivalTerminal

Text

The arrival airport terminal.

reservationFor.boardingTime

DateTime

The time when the flight starts boarding.

reservationFor.departureGate

Text

The gate number at the departure airport.

reservationFor.departureTerminal

Text

The departure airport terminal.

reservationFor.webCheckinTime

DateTime

The time when online check-in for the flight starts.

ticketDownloadUrl

URL

The address of the page where the boarding pass can be downloaded.

ticketNumber

Text

The ticket number.

ticketPrintUrl

URL

The address of the page where the boarding pass can be printed.

url

URL

The address of the page with information about the booking.

Values of the reservationStatus property

  • "http://schema.org/ReservationConfirmed": Ticket purchase confirmed.
  • "http://schema.org/ReservationCancelled": Flight canceled.
  • "http://schema.org/ReservationHold": Reservation awaiting payment.
  • "http://schema.org/ReservationPending": Reservation awaiting confirmation.

Contact support



You can also go to

  • "http://schema.org/ReservationConfirmed": Ticket purchase confirmed.
  • "http://schema.org/ReservationCancelled": Flight canceled.
  • "http://schema.org/ReservationHold": Reservation awaiting payment.
  • "http://schema.org/ReservationPending": Reservation awaiting confirmation.

Type

ReservationStatus

Description

Reservation status.

Possible values

Previous
Markup for emails
Next
Online shopping