In this help center, you can find content for both Merchant Center Next and the classic Merchant Center experience. Look for the logo at the top of each article to make sure you're using the article for the Merchant Center version that applies to you. 

Expiration date [expiration_date]

A custom icon for Merchant Center Classic and Merchant Center Next.

Use the expiration 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

If you want to set an earlier expiration date than the 30-day default, use the expiration date [expiration_date] attribute to submit that date. Your product data expires after 30 days, and your product stops showing.


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

Learn when and how to submit your product data in English


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.

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 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 go beyond the basic requirements to optimize 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 AM, midnight, in the UTC time zone.
  • 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 data for brown lederhosen
Attribute Value
Title [title] Lederhosen - brown - L
Expiration date [expiration_date] 2016-12-25T00:01-0800
Was this helpful?
How can we improve it?

Need more help?

Sign in for additional support options to quickly solve your issue

Clear search
Close search
Google apps
Main menu
Search Help Center