Use this type to declare a reservation for one or more guests at a restaurant
or other food establishment.

## Use cases

Follow this example to ensure that your `FoodEstablishmentReservation` markup
is properly structured.

> [!NOTE]
> **Note:** Before you start, review how to [embed schemas in emails](https://developers.google.com/workspace/gmail/markup/getting-started) and [test schemas](https://developers.google.com/workspace/gmail/markup/testing-your-schema).

### Basic restaurant reservation

This is an example of the minimal amount of markup that qualifies your email as
a `FoodEstablishmentReservation`.

### JSON-LD

    <script type="application/ld+json">
    {
      "@context": "http://schema.org",
      "@type": "FoodEstablishmentReservation",
      "reservationNumber": "OT12345",
      "reservationStatus": "http://schema.org/Confirmed",
      "underName": {
        "@type": "Person",
        "name": "John Smith"
      },
      "reservationFor": {
        "@type": "FoodEstablishment",
        "name": "Wagamama",
        "address": {
          "@type": "PostalAddress",
          "streetAddress": "1 Tavistock Street",
          "addressLocality": "London",
          "addressRegion": "Greater London",
          "postalCode": "WC2E 7PG",
          "addressCountry": "United Kingdom"
        }
      },
      "startTime": "2027-04-10T08:00:00+00:00",
      "partySize": "2"
    }
    </script>

### Microdata

    <div itemscope itemtype="http://schema.org/FoodEstablishmentReservation">
      <meta itemprop="reservationNumber" content="OT12345"/>
      <link itemprop="reservationStatus" href="http://schema.org/Confirmed"/>
      <div itemprop="underName" itemscope itemtype="http://schema.org/Person">
        <meta itemprop="name" content="John Smith"/>
      </div>
      <div itemprop="reservationFor" itemscope itemtype="http://schema.org/FoodEstablishment">
        <meta itemprop="name" content="Wagamama"/>
        <div itemprop="address" itemscope itemtype="http://schema.org/PostalAddress">
          <meta itemprop="streetAddress" content="1 Tavistock Street"/>
          <meta itemprop="addressLocality" content="London"/>
          <meta itemprop="addressRegion" content="Greater London"/>
          <meta itemprop="postalCode" content="WC2E 7PG"/>
          <meta itemprop="addressCountry" content="United Kingdom"/>
        </div>
      </div>
      <meta itemprop="startTime" content="2027-04-10T08:00:00+00:00"/>
      <meta itemprop="partySize" content="2"/>
    </div>

## Test your markup

You can validate your markup using the
[Email Markup Tester Tool](https://www.google.com/webmasters/markup-tester/).
Paste in your markup code and click the **Validate** button to scan the content
and receive a report on any errors present.

## Specification

Review the details of your email to see if any of these additional properties
apply to your reservation. By marking up these additional properties, you allow
Google to display a much richer description of the reservation to the user.

# FoodEstablishmentReservation

Type name: [FoodEstablishmentReservation](https://developers.google.com/workspace/gmail/markup/reference/types/FoodEstablishmentReservation)

Extends [Reservation](https://developers.google.com/workspace/gmail/markup/reference/types/Reservation)

| Name | Type | Description |
|---|---|---|
| **bookingAgent** | [Organization](https://developers.google.com/workspace/gmail/markup/reference/types/Organization) or [Person](https://developers.google.com/workspace/gmail/markup/reference/types/Person) | Booking agent or agency. Also accepts a string (e.g. ""). |
| bookingAgent.**name** | [Text](https://developers.google.com/workspace/gmail/markup/reference/types/Text) | Name of the agent/service. |
| bookingAgent.**url** | [URL](https://developers.google.com/workspace/gmail/markup/reference/types/URL) | Website of the agent/service. |
| **bookingTime** | [DateTime](https://developers.google.com/workspace/gmail/markup/reference/types/DateTime) | Date the reservation was made. |
| **cancelReservationUrl** | [URL](https://developers.google.com/workspace/gmail/markup/reference/types/URL) | Web page where reservation can be cancelled. |
| **confirmReservationUrl** | [URL](https://developers.google.com/workspace/gmail/markup/reference/types/URL) | Web page where reservation can be confirmed. |
| **modifiedTime** | [DateTime](https://developers.google.com/workspace/gmail/markup/reference/types/DateTime) | (recommended for Confirmation Cards/Search Answers) Time the reservation was last modified. |
| **modifyReservationUrl** | [URL](https://developers.google.com/workspace/gmail/markup/reference/types/URL) | (recommended for Confirmation Cards/Search Answers) Web page where reservation can be modified. |
| **partySize** **(Required)** | [Number](https://developers.google.com/workspace/gmail/markup/reference/types/Number) | Number of people in the party. |
| **price** | [Text](https://developers.google.com/workspace/gmail/markup/reference/types/Text) | Total price of the FoodEstablishmentReservation. |
| **priceCurrency** | [Text](https://developers.google.com/workspace/gmail/markup/reference/types/Text) | The currency (in 3-letter ISO 4217 format) of the FoodEstablishmentReservation's price.'' |
| **programMembership** | [ProgramMembership](https://developers.google.com/workspace/gmail/markup/reference/types/ProgramMembership) | Any membership in a frequent flyer, hotel loyalty program, etc. being applied to the reservation. |
| programMembership.**memberNumber** | [Text](https://developers.google.com/workspace/gmail/markup/reference/types/Text) | The identifier of the membership. |
| programMembership.**program** | [Text](https://developers.google.com/workspace/gmail/markup/reference/types/Text) | The name of the program. |
| **reservationFor** **(Required)** | [FoodEstablishment](https://developers.google.com/workspace/gmail/markup/reference/types/FoodEstablishment) | The food establishment the reservation is for. |
| reservationFor.**address** **(Required)** | [PostalAddress](https://developers.google.com/workspace/gmail/markup/reference/types/PostalAddress) | Address of the restaurant. |
| reservationFor.address.**addressCountry** **(Required)** | [Country](https://developers.google.com/workspace/gmail/markup/reference/types/Country) or [Text](https://developers.google.com/workspace/gmail/markup/reference/types/Text) | Country of restaurant. |
| reservationFor.address.**addressLocality** **(Required)** | [Text](https://developers.google.com/workspace/gmail/markup/reference/types/Text) | Locality (e.g. city) of restaurant. |
| reservationFor.address.**addressRegion** **(Required)** | [Text](https://developers.google.com/workspace/gmail/markup/reference/types/Text) | Region (e.g. State) of restaurant. |
| reservationFor.address.**postalCode** **(Required)** | [Text](https://developers.google.com/workspace/gmail/markup/reference/types/Text) | Postal code of restaurant. |
| reservationFor.address.**streetAddress** **(Required)** | [Text](https://developers.google.com/workspace/gmail/markup/reference/types/Text) | Street address of restaurant. |
| reservationFor.**image** | [URL](https://developers.google.com/workspace/gmail/markup/reference/types/URL) | Image of the restaurant. |
| reservationFor.**name** **(Required)** | [Text](https://developers.google.com/workspace/gmail/markup/reference/types/Text) | Name of the restaurant. |
| reservationFor.**telephone** | [Text](https://developers.google.com/workspace/gmail/markup/reference/types/Text) | Telephone number of the FoodEstablishment. |
| reservationFor.**url** | [URL](https://developers.google.com/workspace/gmail/markup/reference/types/URL) | Restaurant's website. |
| **reservationNumber** **(Required)** | [Text](https://developers.google.com/workspace/gmail/markup/reference/types/Text) | The number or id of the reservation. |
| **reservationStatus** **(Required)** | [ReservationStatus](https://developers.google.com/workspace/gmail/markup/reference/types/ReservationStatus) | Current status of the reservation. |
| **startTime** **(Required)** | [DateTime](https://developers.google.com/workspace/gmail/markup/reference/types/DateTime) | Reservation date and time. |
| **underName** **(Required)** | [Organization](https://developers.google.com/workspace/gmail/markup/reference/types/Organization) or [Person](https://developers.google.com/workspace/gmail/markup/reference/types/Person) | The person the table is for. |
| underName.**email** | [Text](https://developers.google.com/workspace/gmail/markup/reference/types/Text) | Email address. |
| underName.**name** **(Required)** | [Text](https://developers.google.com/workspace/gmail/markup/reference/types/Text) | Name of the Person. |
| **url** | [URL](https://developers.google.com/workspace/gmail/markup/reference/types/URL) | Web page where reservation can be viewed. |

> [!NOTE]
> **Note:** Some schemas that Google uses are still going through the standardization process of [Schema.org](https://schema.org) and might change in the future. For more information, see [Schema.org proposals](https://developers.google.com/workspace/gmail/markup/reference/schema-org-proposals).