Expiry date [expiration_date]

Use the expiry date [expiration_date] attribute to stop showing a product on a specific date. For example, you can use this attribute for limited stock or seasonal products.

In this article

When to use

Optional Optional for each product

All products expire from your Merchant Center account 30 days after the last refresh. Products added directly in Merchant Center don’t expire. Learn more on how to Quickly add or update your products directly in Merchant Center. Products can be refreshed by re-submitting your feed or scheduling regular feed uploads. Google will also regularly check your website and refresh your products automatically if the product data can be validated, for example, by the crawling of schema.org structured data on your product landing pages.

If you want to set a specific expiration date, use the expiration date [expiration_date] attribute to submit that date.Your product will expire on the specified date or 30 days after the last refresh, which ever is sooner.

Format

Follow these formatting guidelines to make sure that Google understands the data that you submit.

Learn when and how to submit your product data in English

Type

Date, time and time zone, ISO 8601 compliant

(YYYY-MM-DDThh:mm[±hhmm] or YYYY-MM-DDThh:mmZ)

Limits 25 characters
Repeated field No
 
File format Example value
Text feeds 2016-02-24T00:30-0800
XML feeds <g:expiration_date>2016-02-24T00:30-0800</g:expiration_date>

To format your data for Content API, go to the Content API for Shopping resource.

Note: To ensure that this product data attribute is recognised by our system correctly, remember to submit your data feed file in a format that we support.

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 in your Merchant Center account.

  • Provide a date up to one year in the future.
  • Note: While the purpose of this attribute is to stop showing your product at the exact time that you submit, it may take several hours to take effect.

Best practices

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

  • Specify a time and time zone in addition to the date. If you don't, the default time is 12 a.m. (midnight) in the UTC time zone.
  • Specify when your product should stop being shown. If you're selling a product for a brief period of time, use this attribute to stop your product being shown on a specific day.

Example

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

An example ad showing how you can select different sizes for a product

Product data for brown lederhosen
Attribute Value
Title [title] Lederhosen – Brown – L
Expiry date [expiration_date] 2016-12-25T00:01-0800

Was this helpful?

How can we improve it?
false
Search
Clear search
Close search
Google apps
Main menu
7242737884397692038
true
Search Help Centre
true
true
true
true
true
71525
false
false