Help Center

| Submit or View Help Requests | Developer Docs |
| |

Add, Manage, & Troubleshoot Promotion Files

The Product Promotions feature allows you to share your special offers and promotions with partners. These promotions will be accessible to partners on their product feeds, product APIs, and’s product marketplace, where partners will see a Special offer tag displayed on the products. Partners will also be able to filter for products on promotion.


Upload a promotion file


You'll need to have an active product catalog before you can begin. For help creating your first product upload, see this doc.

  1. From the left navigation panel, select engage-icon__v69b8313.svg [Engage] → Content → Products [Drop-down menu]Product Promotions.

    image idm45641999334752
  2. In the upper-right of the page, select Upload Promotion File.

  3. Enter your Promotion File Name.

  4. Select your Upload Method.

    1. Select the file Format.

      • only supports Google Merchant Center (TXT format) i.e. .txt and Google Merchant Center (CSV format) i.e. .csv files.

      • Refer to the Product promotion feed field reference below for more information on these fields.

    2. Select Choose File.

      • Locate the file you want to upload from your computer.

  5. Select your preferred Language and Save.

    image idm45641999329984
Product promotion feed field reference

Expected fields




ID [promotion_id]


The unique ID of each promotion.

This ID is in number format and should not contain spaces or symbols, e.g., 103330482.

Applicability [product_applicability]


This attribute specifies if the promotion applies to all products or only to specific products.

Supported values:

  • all_products

  • specific_products

Important can only map the promotions in your Google promotions feed file external-link-alt-solid.svg [External link] with specific products in your product feed file (i.e., your product catalog) if your product feed includes promotion_id. In other words, you cannot have the specific_products value if your product feed does not include promotion IDs.

Description [long_title]


The full title of each promotion.

The maximum length of the title is 60 characters, e.g., Free mug with purchase.

Effective [promotion_effective_dates]


The period for the promotion.

  • The start and end dates 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.

  • Example: 2009-07-19T03:00:00+00:00/2009-07-26T21:00:00+00:00

Display [promotion_display_dates]


This attribute specifies the date and the time frame when the promotion will be live.

The start and end dates are separated by a forward slash (/), e.g., 2009-07-19T03:00:00+00:00/2009-07-26T21:00:00+00:00.

Channel [redemption_channel]


This attribute indicates that the promotion is valid online or in-store.

Supported values:

  • online

  • in_store

Offer Code Type [offer_type]


This attribute indicates whether or not a coupon code is required for customers to redeem the offer.

Supported values:

  • no_code

  • generic_code


If the value for this attribute is generic_code, generic_redemption_code is required.

Offer Code [generic_redemption_code]


This attribute specifies the code that can be used online to redeem the promotion.

The maximum length is 20 characters, e.g., EXTRA20.

Destination [promotion_destination]


This attribute specifies the format of each promotion.

Supported values:

  • Shopping_ads

  • Buy_on_Google_listings

  • Free_listings


To submit your promotion to one or more destinations, submit each destination value as a separate column.

View or delete promotion files

Once you've uploaded your list of promotions, they will display as follows:

image idm45641999325216
  • To view uploaded product promotions, select ellipsis-h-solid__1_.svg [More]View Promotions.

  • To delete your uploaded product promotions, select Delete.

Download and filter promotion files

  • To download the promotion files, select download1.svg [Download] and to add or remove column headers, select columns-solid__1_.svg [Column].

  • Search for a particular promotion file by typing part of the description in the Description box and selecting Enter on your keyboard.

Promotion file health indicator

If promotion files contain any errors or warnings, you’ll see a total of each in the Health column. The color of the indicator changes according to the health of the uploaded promotion file:

image idm45641999315680




Your file is uploading and being processed.


Your file has no errors or warnings.


Certain suggested fields that contain crucial data could be missing, however, your file will still be uploaded.


Required information is missing in more than 10% of the records you sent in. You will have to fix and re-upload the file.

Troubleshoot error and warning messages

View errors and warnings

On the Product Promotions screen, under the Health column, select errors or warnings to see more information about the error, like the error type or error message.

image idm45641999310912
Search and filter errors

You can use the search field and filters to better sort through the product promotion upload errors.

image idm45641999306144

The Error Type filters include the following:

  • All

  • Warning

  • Error

  • Duplicate

Error and warning messages

Error Message


Required field(s) missing:{Required field}

One or more of the required fields are missing in the upload file.

Records skipped due to an expired effective date

The promotion's effective end date is in the past and that record is skipped.

Did you find it helpful? Yes No

Send feedback
Sorry we couldn't be helpful. Help us improve this article with your feedback.