Promotion start date [promotion_effective_dates]

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

Use the promotion start date [promotion_effective_dates] attribute to set a start date and end date for your promotion.

When to use

Required for all promotions.

Format

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

Type	Unicode characters (recommended: ASCII only)
Repeated field	No

File format Example entry

Text feeds

Start date and end date are separated by a forward slash (/).
The date format is (YYYY-MM-DD), followed by the letter 'T', the time of day when the sale starts or ends, and an expression of the time zone for the sale.
If your promotion was valid from 3.00 a.m. on 19 July 2009 to 9.00 p.m. on 26 July 26 2009 EST (Eastern Standard Time), you would submit:
- 2009-07-19T03:00:00-05:00/2009-07-26T21:00:00-05:00
If your promotion was valid from 3.00 a.m. on 19 July 2009 to 9.00 p.m. on 26 July 26 2009 GMT (Greenwich Mean Time), you would submit:
- 2009-07-19T03:00:00+00:00/2009-07-26T21:00:00+00:00

XML feeds

<g:promotion_effective_dates>2009-07-19T03:00:00-05:00/2009-07-26T21:00:00-05:00</g:promotion_effective_dates>

<g:promotion_effective_dates>2009-07-19T03:00:00+00:00/2009-07-26T21:00:00+00:00</g:promotion_effective_dates>

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

Minimum requirements

These are the requirements that you must meet to show your promotion in Merchant Center. If you don't follow these requirements, your product is disapproved and you receive a notification in your Merchant Center account.

Promotions have a six-month limit (183 days).

Best practices

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

GMT is Greenwich Mean Time. -5 hours represents EST, while -8 hours represents PST.
Daylight savings: -4 hours represents EDT, while -7 hours represents PDT.
If you use the promotion builder, it will only support the promotion start date [promotion_effective_dates] attribute and the time will default to the time zone of your Merchant Center account setting. If you want the promotion to be in a different time zone, adjust the time zone manually.
You can validate your promotion before it starts by using the promotion display dates [promotions_display_dates] attribute. Learn more about promotions feed formatting and attributes.

Examples

A promotion that offers 50% off for the New Year

Attribute	Value
Promotion ID `[promotion_id]`	`new_years_sale`
Promotion title `[long_title]`	`50% off for the New Year`
Percentage discount amount `[percent_off]`	`50`
Promotion start date `[promotion_effective_dates]`	`2019-12-30T03:00:00+00:00/2020-01-01T21:00:00+00:00`

Was this helpful?

How can we improve it?