expiration_date: Definition

Use the expiration_date attribute to cause a product to stop showing ads on a specific date and time. 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 ads for that product stop showing. 

Format

Follow these formatting guidelines to make sure we understand the data 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
 
File format Example value
Text feeds

2016-02-24

XML feeds <g:expiration_date>2016-02-24</g:expiration_date>
Content API v2 (JSON) "expirationDate": "2016-02-24"
Content API v2 (XML) <expiration_date>2016-02-24</expiration_date>

Guidelines

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

Minimum requirements

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

Best practices

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

  • Specify when ads should stop showing for a product. If you’re selling a product for a brief period, use this attribute to stop showing ads at a specific moment.
  • Specify a time in addition to the date. If you don't add a time, the default time is midnight in the time zone of the target country. 

Examples

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-25T13:00-0800
Was this article helpful?
How can we improve it?