expiration_date: Definition


Use the expiration_date attribute to cause a product to stop showing 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 expiration date than the 30-day default, use the expiration_date attribute to submit that date. Your product data expires after 30 days, because it's no longer fresh, and your product stops showing.


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


Date only, ISO 8601 compliant

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

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, see the Content API for Shopping.


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

Minimum requirements

These are the requirements 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 Diagnostics in 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 you submit can't be used.

Best practices

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

  • Specify when your product should stop showing. If you’re selling a product for a brief period of time, use this attribute to stop showing your product on a specific day.


Product is available for preorders with a specific release date

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

Product Lederhosen
title Lederhosen - brown - L
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