expiration_date [expiration_date]: Definition

Use the expiration_date[expiry_date] attribute to cause a product to stop being shown on a specific date. For example, you might want to do this for limited stock or seasonal products.

When to use

Optional for each product

If you want to set an earlier expiry date than the 30-day default, use the expiration_date [expiration_date] attribute to submit that date. Your product data expires after 30 days, because it's no longer fresh, and your product stops being shown.


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


Date only, ISO 8601 compliant


Limits 10 characters
Repeated field No
File format Example value
Text feeds


XML feeds <g:expiration_date>2016-02-24</g:expiration_date>

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


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.

  • 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.


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 Lederhosen
title [title] Lederhosen – Brown – L
expiration_date [expiration_date] 2016-12-25

Was this helpful?
How can we improve it?

Need more help?

Sign in for additional support options to quickly solve your issue