Parcel Delivery

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.