availability_date [availability_date]: Definition

Use the availability_date [availability_date] attribute to tell users when a pre-ordered product will be shipped. 

When to use

Optional for each product

If you set the availability [availability] attribute to preorder [pre-order], you can provide the date that your product will be dispatched using availability_date [availability_date].

Format

Follow these formatting guidelines to make sure that we understand the data that you're submitting. 

Type

Date and time, ISO 8601 compliant

(YYYY-MM-DD, YYYY-MM-DDThh:mm:ss, or YYYY-MM-DDThh:mm:ssZ)

Limits 1-25 characters
Repeated field No
Schema.org property
(What is this?)

Offer.availabilityStarts, Offer.availabilityEnds, Type: DateTime

 
File format Example value
Text feeds

2016-12-25T13:00-0800

XML feeds <g:availability_date>2016-11-25T13:00-0800</g:availability_date>


To format your data for Content API, have a look at the Content API for Shopping.

Guidelines

Follow these guidelines to make sure that you submit high-quality data for your products.

Minimum requirements

These are the requirements that you'll need to meet to show your product. If you don't follow these requirements, we'll disapprove your product and let you know on the Diagnostics page of your Merchant Center account.

  • Ensure that you only use this attribute if you are sure that your product doesn't have any assigned unique product identifiers. 
  • Products for which the identifier_exists [identifier_exists] attribute is incorrectly set to no [no] or false [false], and for which there is evidence that a unique product identifier exists, will be disapproved.

Best practices

These best practices can help you go beyond the basic requirements to optimise your product data for performance.

  • Only submit the availability_date [availability_date] attribute for products with availability [availability] set to preorder [pre-order]
  • Specify a time in addition to the date. If you don't, the default time is 12 a.m., midnight, in the time zone of your target country. 
  • Don’t include an estimated date or a date range. We recommend that you provide a release date only when it's specific to help set the best expectations for users. The attribute is optional, not required and you don't need to include a date that's potentially confusing.

Examples

Product is available for pre-orders with a specific release date

An illustration of an android plush 

Product Android Squishable
availability [availability] preorder [pre-order]
availability_date [availability_date] 2016-12-25T13:00-0800
Product is available for pre-order with no specific release date

An illustration of an android plush 

Product Android Squishable
availability [availability] preorder [pre-order]
availability_date [availability_date] None, since the date isn't available
Get ready for the release date 

An illustration of an android plush 

Release status Not released
Product Android Squishable
availability [availability] preorder [pre-order]
availability_date [availability_date] 2016-12-25T13:00-0800
   
Release status Released
Product Android Squishable
availability [availability] in stock [in stock]
availability_date [availability_date] None, since the product is no longer available for pre-order
Was this helpful?
How can we improve it?

Need more help?

Sign in for additional support options to quickly solve your issue