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 detailing 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. 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 | (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 | (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 | 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 | 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 | The earliest date the package is expected to arrive. |
| expectedArrivalUntil | DateTime | (required) The latest date the package is expected to arrive. |
| carrier | 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 or 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 | 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 | Method used for delivery. |
| deliveryStatus | 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 | (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 or 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 | (recommended for confirmation cards/Search Answers) The current status of the order. |