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>


For format API information, please see Content API for Shopping.

Guidelines

Follow these guidelines to make sure that you submit high-quality data for your products and get the best performance from your ads.

Minimum requirements

These are the requirements that you'll need to meet to show ads for 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. 

  • There are no minimum requirements for this attribute. Keep in mind that you still need to follow the formatting guidelines or the information that you submit can't be used.

Best practices

These are best practices that 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