---
metadata:
  - name: generator
    content: Diplodoc Platform v5.55.2
alternate:
  - https://yandex.ru/support/webmaster/en/mail/flight.md
  - https://yandex.ru/support/webmaster/ru/mail/flight.md
  - href: en/mail/flight.md
    type: text/markdown
    title: Markdown version
  - href: ../llms.txt
    type: text/markdown
    title: llms.txt
---
> **Documentation Index:** Fetch the complete configuration index at https://yandex.ru/support/webmaster/en/llms.txt


# 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](https://yandex.ru/support/webmaster/en/schema-org/what-is-schema-org.md) markup.

![](../_assets/mail-avia.png)

## How to mark up emails {#inst}

To mark up your emails:
1. Take into account the [Yandex requirements](https://yandex.ru/support/mail/web/letter/create/send-many-letters.html) for mail-outs. Make sure that the domain you want to send the emails from complies with the requirements.
1. Use the [FlightReservation](#example) type of the Schema.org standard supported by Yandex Mail and one of two data description formats: [Microdata](https://yandex.ru/support/webmaster/en/schema-org/what-is-schema-org.md) or [JSON-LD](https://yandex.ru/support/webmaster/en/json-ld/about.md).
1. [Validate](https://webmaster.yandex.ru/site/tools/microtest/) your markup.

If you did everything listed above but your markup doesn't work, fill out the [form at the bottom of the page](#form):
1. Select "Widgets (highlighting emails in the email list)".
1. In your message, specify the domain you want to send emails from.
1. Wait for a response from the support team.


## Examples of markup {#structure}

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 {#confirm-flight}

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


{% cut "JSON-LD" %}


```xml

```


{% endcut %}

{% cut "Microdata" %}


```xml
<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>
```


{% endcut %}


### Boarding pass {#board-pass}

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


{% cut "JSON-LD" %}


```xml

```


{% endcut %}

{% cut "Microdata" %}


```xml
<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>
```


{% endcut %}


### Changes in the schedule {#rasp}

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


{% cut "JSON-LD" %}


```xml

```


{% endcut %}

{% cut "Microdata" %}


```xml
<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>
```


{% endcut %}


### Flight cancellation {#flight-cancellation}

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


{% cut "JSON-LD" %}


```xml

```


{% endcut %}

{% cut "Microdata" %}


```xml
<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>
```


{% endcut %}


### A flight with multiple legs {#segments}

Describe each flight leg in a separate element of the [FlightReservation](http://schema.org/FlightReservation) type.


{% cut "JSON-LD" %}


```xml

```


{% endcut %}

{% cut "Microdata" %}


```xml
<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>
```


{% endcut %}



## The properties of the FlightReservation type supported by Yandex Mail {#example}


#|
||
**Property**
|
**Type**
|
**Description**
||
||
**Required**
|
>
|
>
||
||
reservationId
|
[Text](https://schema.org/Text)
|
The booking number.
||
||
reservationStatus
|
[ReservationStatus](https://schema.org/reservationStatus)
|
Reservation status.
[Possible values](*reservationstatus-values)
||
||
reservationFor
|
[Flight](https://schema.org/Flight)
|
Information about the flight that the passenger booked a ticket for.
||
||
reservationFor.arrivalAirport
|
[Airport](https://schema.org/Airport)
|
Information about the destination airport.

This field can also have a value of the [Text](https://schema.org/Text) type, such as "Domodedovo".
||
||
reservationFor.arrivalAirport.iataCode
|
[Text](https://schema.org/Text)
|
The destination airport's IATA code, such as "DME".
||
||
reservationFor.arrivalAirport.name
|
[Text](https://schema.org/Text)
|
The destination airport's name.
||
||
reservationFor.arrivalTime
|
[DateTime](https://schema.org/DateTime)
|
The time of arrival at the destination airport.
||
||
reservationFor.departureAirport
|
[Airport](https://schema.org/Airport)
|
Information about the departure airport.

This field can also have a value of the [Text](https://schema.org/Text) type, such as "Domodedovo".
||
||
reservationFor.departureAirport.iataCode
|
[Text](https://schema.org/Text)
|
The departure airport's IATA code, such as "DME".
||
||
reservationFor.departureAirport.name
|
[Text](https://schema.org/Text)
|
The departure airport's name.
||
||
reservationFor.departureTime
|
[DateTime](https://schema.org/DateTime)
|
The departure time.
||
||
reservationFor.flightNumber
|
[Text](https://schema.org/Text)
|
The flight number.
||
||
**Optional**
|
>
|
>
||
||
additionalTicketText
|
[Text](https://schema.org/Text)
|
Additional information about the boarding pass.
||
||
boardingGroup
|
[Text](https://schema.org/Text)
|
Airline-specific information about boarding.
||
||
bookingAgent
|
[Organization](https://schema.org/Organization) or [Person](https://schema.org/Person)
|
Information about the agent booking the ticket.
||
||
bookingAgent.name
|
[Text](https://schema.org/Text)
|
The name of the agent booking the ticket.
||
||
bookingAgent.url
|
[URL](https://schema.org/url)
|
The site address of the agent booking the ticket.
||
||
bookingTime
|
[DateTime](https://schema.org/DateTime)
|
The time of booking.
||
||
modifiedTime
|
[DateTime](https://schema.org/DateTime)
|
The time when the flight details were last updated.
||
||
potentialAction
|
[ConfirmAction](https://schema.org/ConfirmAction), [CancelAction](https://schema.org/CancelAction), or [CheckInAction](https://schema.org/CheckInAction)
|
Potential actions affecting the booking, such as confirmation, cancellation, or check-in.
||
||
potentialAction.target
|
[EntryPoint](https://schema.org/EntryPoint)
|
The pointer to a booking-related action (typically a link to the site).
||
||
reservationFor.provider
|
[Airline](https://schema.org/Airline)
|
Information about the airline operating the flight.
||
||
reservationFor.provider.name
|
[Text](https://schema.org/Text)
|
The airline name.
||
||
reservationFor.provider.iataCode
|
[Text](https://schema.org/Text)
|
The airline's IATA code.
||
||
reservationFor.arrivalGate
|
[Text](https://schema.org/Text)
|
The gate number at the arrival airport.
||
||
reservationFor.arrivalTerminal
|
[Text](https://schema.org/Text)
|
The arrival airport terminal.
||
||
reservationFor.boardingTime
|
[DateTime](https://schema.org/DateTime)
|
The time when the flight starts boarding.
||
||
reservationFor.departureGate
|
[Text](https://schema.org/Text)
|
The gate number at the departure airport.
||
||
reservationFor.departureTerminal
|
[Text](https://schema.org/Text)
|
The departure airport terminal.
||
||
reservationFor.webCheckinTime
|
[DateTime](https://schema.org/DateTime)
|
The time when online check-in for the flight starts.
||
||
ticketDownloadUrl
|
[URL](https://schema.org/url)
|
The address of the page where the boarding pass can be downloaded.
||
||
ticketNumber
|
[Text](https://schema.org/Text)
|
The ticket number.
||
||
ticketPrintUrl
|
[URL](https://schema.org/url)
|
The address of the page where the boarding pass can be printed.
||
||
url
|
[URL](https://schema.org/url)
|
The address of the page with information about the booking.
||
|#

### Values of the reservationStatus property {#reservationstatus-values}

- `"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.



<div class="cut-button">

#### {#form}

{% cut "Contact support" %}


<div style="padding: 15px;
     margin: 10px 0;
     background: #FFFFFF;
     border-radius: 10px;
     border: 1px solid var(--yc-color-line-generic);">
  <iframe style="background: #FFFFFF;"
        height="700"
        width="100%"
        frameborder="0"
        src="https://forms.yandex.ru/surveys/5476/?&iframe=1&lang=en">
  </iframe>
</div>

{% endcut %}

</div>


<!-- source: en/_includes/footer.md -->
<div width="100%" align="center" class="main-footer"> 
<br><br><br>
You can also go to 
<br><br>


[![](../_assets/logo/logo-pic.svg)](https://webmaster.yandex.ru/) [![](../_assets/logo/logo-ru.svg)](https://webmaster.yandex.ru/)





</div>


<!-- source: en/_includes/styles/footer-style.md -->

<!-- endsource: en/_includes/styles/footer-style.md -->
<!-- endsource: en/_includes/footer.md -->

<!-- source: en/_includes/cut-button-style.md -->

<!-- endsource: en/_includes/cut-button-style.md -->

<!-- source: en/_includes/remove-3lvl-minitoc.md -->

<!-- endsource: en/_includes/remove-3lvl-minitoc.md -->

[*reservationstatus-values]: - `"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.

[*reservationStatus]: **Type**

[ReservationStatus](https://schema.org/reservationStatus)

**Description**

Reservation status.

[Possible values](*reservationstatus-values)