Use this template to describe package delivery status.

## Use cases

### Basic parcel delivery

Minimal example for a parcel delivery:

### JSON-LD

    <script type="application/ld+json">
    {
      "@context": "http://schema.org",
      "@type": "ParcelDelivery",
      "deliveryAddress": {
        "@type": "PostalAddress",
        "name": "Pickup Corner",
        "streetAddress": "24 Willie Mays Plaza",
        "addressLocality": "San Francisco",
        "addressRegion": "CA",
        "addressCountry": "US",
        "postalCode": "94107"
      },
      "expectedArrivalUntil": "2027-03-12T12:00:00-08:00",
      "carrier": {
        "@type": "Organization",
        "name": "FedEx"
      },
      "itemShipped": {
        "@type": "Product",
        "name": "Google Chromecast"
      },
      "partOfOrder": {
        "@type": "Order",
        "orderNumber": "176057",
        "merchant": {
          "@type": "Organization",
          "name": "Bob Dole"
        }
      }
    }
    </script>

### Microdata

    <div itemscope itemtype="http://schema.org/ParcelDelivery">
      <div itemprop="deliveryAddress" itemscope itemtype="http://schema.org/PostalAddress">
        <meta itemprop="name" content="Pickup Corner"/>
        <meta itemprop="streetAddress" content="24 Willie Mays Plaza"/>
        <meta itemprop="addressLocality" content="San Francisco"/>
        <meta itemprop="addressRegion" content="CA"/>
        <meta itemprop="addressCountry" content="US"/>
        <meta itemprop="postalCode" content="94107"/>
      </div>
      <meta itemprop="expectedArrivalUntil" content="2027-03-12T12:00:00-08:00"/>
      <div itemprop="carrier" itemscope itemtype="http://schema.org/Organization">
        <meta itemprop="name" content="FedEx"/>
      </div>
      <div itemprop="itemShipped" itemscope itemtype="http://schema.org/Product">
        <meta itemprop="name" content="Google Chromecast"/>
      </div>
      <div itemprop="partOfOrder" itemscope itemtype="http://schema.org/Order">
        <meta itemprop="orderNumber" content="176057"/>
        <div itemprop="merchant" itemscope itemtype="http://schema.org/Organization">
          <meta itemprop="name" content="Bob Dole"/>
        </div>
      </div>
    </div>

### Parcel delivery with shipping information

Example parcel delivery with detailed shipping information:

### JSON-LD

    <script type="application/ld+json">
    {
      "@context": "http://schema.org",
      "@type": "ParcelDelivery",
      "deliveryAddress": {
        "@type": "PostalAddress",
        "name": "John Frank",
        "streetAddress": "24 Willie Mays Plaza",
        "addressLocality": "San Francisco",
        "addressRegion": "CA",
        "addressCountry": "US",
        "postalCode": "94107"
      },
      "originAddress": {
        "@type": "PostalAddress",
        "name": "John Frank",
        "streetAddress": "25 Willie Mays Plaza",
        "addressLocality": "San Francisco",
        "addressRegion": "CA",
        "addressCountry": "US",
        "postalCode": "94107"
      },
      "expectedArrivalFrom": "2027-03-10T12:00:00-08:00",
      "expectedArrivalUntil": "2027-03-12T12:00:00-08:00",
      "carrier": {
        "@type": "Organization",
        "name": "FedEx",
        "url": "http://fedex.com/"
      },
      "itemShipped": {
        "@type": "Product",
        "name": "iPod Mini",
        "url": "http://apple.com/ipad32gb",
        "image": "http://apple.com/images/ipad32gb.jpg",
        "sku": "B00DR0PDNE",
        "description": "iPod Mini 32Gb White",
        "brand": {
          "@type": "Brand",
          "name": "Apple"
        },
        "color": "white"
      },
      "trackingNumber": "3453291231",
      "trackingUrl": "http://fedex.com/track/3453291231",
      "potentialAction": {
        "@type": "TrackAction",
        "url": "http://fedex.com/track/3453291231"
      },
      "hasDeliveryMethod": {
        "@type": "ParcelService",
        "name": "http://schema.org/ParcelService"
      },
      "partOfOrder": {
        "@type": "Order",
        "orderNumber": "176057",
        "merchant": {
          "@type": "Organization",
          "name": "Bob Dole",
          "sameAs": "http://www.freebase.com/m/0fhkx"
        },
        "orderStatus": "http://schema.org/OrderInTransit"
      }
    }
    </script>

### Microdata

    <div itemscope itemtype="http://schema.org/ParcelDelivery">
      <div itemprop="deliveryAddress" itemscope itemtype="http://schema.org/PostalAddress">
        <meta itemprop="name" content="John Frank"/>
        <meta itemprop="streetAddress" content="24 Willie Mays Plaza"/>
        <meta itemprop="addressLocality" content="San Francisco"/>
        <meta itemprop="addressRegion" content="CA"/>
        <meta itemprop="addressCountry" content="US"/>
        <meta itemprop="postalCode" content="94107"/>
      </div>
      <div itemprop="originAddress" itemscope itemtype="http://schema.org/PostalAddress">
        <meta itemprop="name" content="John Frank"/>
        <meta itemprop="streetAddress" content="25 Willie Mays Plaza"/>
        <meta itemprop="addressLocality" content="San Francisco"/>
        <meta itemprop="addressRegion" content="CA"/>
        <meta itemprop="addressCountry" content="US"/>
        <meta itemprop="postalCode" content="94107"/>
      </div>
      <meta itemprop="expectedArrivalFrom" content="2027-03-10T12:00:00-08:00"/>
      <meta itemprop="expectedArrivalUntil" content="2027-03-12T12:00:00-08:00"/>
      <div itemprop="carrier" itemscope itemtype="http://schema.org/Organization">
        <meta itemprop="name" content="FedEx"/>
        <link itemprop="url" href="http://fedex.com/"/>
      </div>
      <div itemprop="itemShipped" itemscope itemtype="http://schema.org/Product">
        <meta itemprop="name" content="iPod Mini"/>
        <link itemprop="url" href="http://apple.com/ipad32gb"/>
        <link itemprop="image" href="http://apple.com/images/ipad32gb.jpg"/>
        <meta itemprop="sku" content="B00DR0PDNE"/>
        <meta itemprop="description" content="iPod Mini 32Gb White"/>
        <div itemprop="brand" itemscope itemtype="http://schema.org/Brand">
          <meta itemprop="name" content="Apple"/>
        </div>
        <meta itemprop="color" content="white"/>
      </div>
      <meta itemprop="trackingNumber" content="3453291231"/>
      <link itemprop="trackingUrl" href="http://fedex.com/track/3453291231"/>
      <div itemprop="potentialAction" itemscope itemtype="http://schema.org/TrackAction">
        <link itemprop="url" href="http://fedex.com/track/3453291231"/>
      </div>
      <div itemprop="hasDeliveryMethod" itemscope itemtype="http://schema.org/ParcelService">
        <meta itemprop="name" content="http://schema.org/ParcelService"/>
      </div>
      <div itemprop="partOfOrder" itemscope itemtype="http://schema.org/Order">
        <meta itemprop="orderNumber" content="176057"/>
        <div itemprop="merchant" itemscope itemtype="http://schema.org/Organization">
          <meta itemprop="name" content="Bob Dole"/>
          <link itemprop="sameAs" href="http://www.freebase.com/m/0fhkx"/>
        </div>
        <link itemprop="orderStatus" href="http://schema.org/OrderInTransit"/>
      </div>
    </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

The following table lists all available properties for this type:

| Property | Type | Description |
|---|---|---|
| deliveryAddress | [PostalAddress](https://developers.google.com/workspace/gmail/markup/reference/types/PostalAddress) | (**required**) Destination address. |
| deliveryAddress.name | Text | Name of the PostalAddress. |
| deliveryAddress.streetAddress | Text | (**required**) The street address. For example, 1600 Amphitheatre Pkwy. |
| deliveryAddress.addressLocality | Text | (**required**) The locality. For example, Mountain View. |
| deliveryAddress.addressRegion | Text | (**required**) The region. For example, CA. |
| deliveryAddress.addressCountry | Text or [Country](https://developers.google.com/workspace/gmail/markup/reference/types/Country) | (**required**) The country. For example, USA. You can also provide the two-letter ISO 3166-1 alpha-2 country code. |
| deliveryAddress.postalCode | Text | (**required**) The postal code. For example, 94043. |
| originAddress | [PostalAddress](https://developers.google.com/workspace/gmail/markup/reference/types/PostalAddress) | Shipper's address. |
| originAddress.name | Text | Name of the PostalAddress. |
| originAddress.streetAddress | Text | The street address. For example, 1600 Amphitheatre Pkwy. |
| originAddress.addressLocality | Text | The locality. For example, Mountain View. |
| originAddress.addressRegion | Text | The region. For example, CA. |
| originAddress.addressCountry | Text or [Country](https://developers.google.com/workspace/gmail/markup/reference/types/Country) | The country. For example, USA. You can also provide the two-letter ISO 3166-1 alpha-2 country code. |
| originAddress.postalCode | Text | The postal code. For example, 94043. |
| expectedArrivalFrom | [DateTime](https://developers.google.com/workspace/gmail/markup/reference/types/DateTime) | The earliest date the package is expected to arrive. |
| expectedArrivalUntil | [DateTime](https://developers.google.com/workspace/gmail/markup/reference/types/DateTime) | (**required**) The latest date the package is expected to arrive. |
| carrier | [Organization](https://developers.google.com/workspace/gmail/markup/reference/types/Organization) | (**required**) The party responsible for the parcel delivery. Also accepts a string (e.g. "FedEx"). |
| carrier.name | Text | (**required**) Name of the Organization. |
| carrier.url | URL | URL of the Organization. |
| itemShipped | [Product](https://developers.google.com/workspace/gmail/markup/reference/types/Product) or [Reservation](https://developers.google.com/workspace/gmail/markup/reference/types/Reservation) | (**required**) Products included in this shipment. To represent quantity, either repeat a Product appropriately or do not use this attribute and use partOfOrder instead to express what Products are included. Also accepts an array of objects. |
| itemShipped.name | Text | (**required**) Name of the Product. |
| itemShipped.url | URL | (**recommended for confirmation cards/Search Answers**) URL of the Product, typically the product landing page on the merchant's website. |
| itemShipped.image | URL | (**recommended for confirmation cards/Search Answers**) URL of an image of the Product, typically an image on the merchant's website. |
| itemShipped.sku | Text | (**recommended for confirmation cards/Search Answers**) The Stock Keeping Unit (SKU), i.e. a merchant-specific identifier for a product or service, or the product to which the offer refers. |
| itemShipped.description | Text | A short description of the Product. |
| itemShipped.brand | [Brand](https://developers.google.com/workspace/gmail/markup/reference/types/Brand) | The brand associated with the Product. |
| itemShipped.brand.name | Text | Name of the Brand. |
| itemShipped.color | Text | The color of the product. |
| trackingNumber | Text | (**recommended for confirmation cards/Search Answers**) Shipper tracking number. |
| trackingUrl | URL | (**recommended for confirmation cards/Search Answers**) Webpage where the package can be tracked. |
| hasDeliveryMethod | [DeliveryMethod](https://developers.google.com/workspace/gmail/markup/reference/types/DeliveryMethod) | Method used for delivery. |
| deliveryStatus | [DeliveryEvent](https://developers.google.com/workspace/gmail/markup/reference/types/DeliveryEvent) | New entry added as the package passes through each leg of its journey (from shipment to final delivery). Especially useful for pickup-style deliveries (e.g. in-store, from a locker). |
| partOfOrder | [Order](https://developers.google.com/workspace/gmail/markup/reference/types/Order) | (**required**) Details of the Order being shipped. When details about Products included in the shipment cannot be expressed by itemShipped (e.g. quantity shipped), use this Order to express Products instead. |
| partOfOrder.orderNumber | Text | (**required**) The merchant-specific identifier for the transaction. |
| partOfOrder.merchant | [Organization](https://developers.google.com/workspace/gmail/markup/reference/types/Organization) or [Person](https://developers.google.com/workspace/gmail/markup/reference/types/Person) | (**required**) The party taking the order (e.g. Amazon.com is a merchant for many sellers). Also accepts a string (e.g. "Bob Dole"). |
| partOfOrder.merchant.name | Text | (**required**) Name of the Organization. |
| partOfOrder.merchant.sameAs | URL | The Freebase URL for the merchant. |
| partOfOrder.orderStatus | [OrderStatus](https://developers.google.com/workspace/gmail/markup/reference/types/OrderStatus) | (**recommended for confirmation cards/Search Answers**) The current status of the order. |