> This page is for Product.

> For clean Markdown of any page, append .md to the page URL.
> For a complete documentation index, see https://docs.feedonomics.com/llms.txt.
> For AI client integration (Claude Code, Cursor, etc.), connect to the MCP server at https://docs.feedonomics.com/_mcp/server.

# Google Promotions

> Create Google Promotions from the self-managed Promotions workspace — fill out the guided form, assign the promotion to products, preview the impact per export, publish, and track its status with Google.

Google Promotions brings Google Shopping promotion management into the self-managed workspace. Instead of routing every promotion request through a support ticket, you can create a Google Promotion, assign it to the right products, and track its status with Google directly in-platform, backed by a direct connection to the Google Merchant API.

> **What Google Promotions are**
>
> Google Promotions are the sale badges and offer details Google displays alongside your products on Google Search, the Shopping tab, Chrome, and more. This workspace creates and manages the promotion itself and assigns it to products. It doesn't edit your underlying Google Shopping product data source directly.

The feature lets you create a promotion through a guided form, assign it to products using the same search-and-select pattern as [Exclude/Include Products](/product/workflows/exclude-include-products) and [Custom Labels](/product/workflows/custom-labels), preview exactly how many products will be assigned before anything is submitted, and track the promotion's status and any Google errors, all in one place.

This guide walks through how to create a promotion, how to assign it to products, how to track its status with Google, and how to escalate to support when needed. Most of it you can do yourself. A Support Specialist is available if you'd rather have the team handle it.

## Open the workspace

You can reach the workspace from the [FeedSupport Portal](/product/account/feedsupport-portal) by selecting the Promotions tile, or directly from the Workspace tab on your Data Page.

### Select the Promotions tile

On the [FeedSupport Portal](/product/account/feedsupport-portal) home screen, select **Promotions**. It sits in the Feedonomics workspaces launcher alongside Exclude/Include Products, Custom Labels, and A/B Testing (coming soon). This opens the Feedonomics workspaces launch page with the Workflow already set to Promotions.

### Select the account and store

Choose the **Account** and **Store name** you want to work in from the dropdowns.

![The Feedonomics workspaces launch page with the workflow set to Promotions, an Account field, a Store name dropdown, a Next button, and a Need support? link.](/_fern-files/_img/08dc367451f50252bd799084d8c56af123093c1c62a6f3e6732a4b307b9b520c.webp)

### Launch the workspace

Select **Next**.

> **Skip the FeedSupport Portal**
>
> If you're already on your Data Page, open the **General Export** view, select the **Workspace** tab, and choose **Promotions**. It appears as an active option alongside Exclude/Include Products and Custom Labels.

![The Data Page with the Workspace tab open and a Choose a workflow panel listing Exclude/include products, Custom labels, Promotions, and A/B testing (coming soon).](/_fern-files/_img/1f6f84cfb469564fc198d3598acf36b9a9162b99c4438baf406ca2319981008e.webp)

## Before you start

Google Promotions has two requirements that must be met before you can submit a promotion. You'll see both reflected at the top of the workflow, along with your export selection and Google connection status.

* Your database must have a **Google Export** connected.
* That Google Export must have **Google authentication (OAuth)** completed.

> **Requirements block the workflow**
>
> If either requirement isn't met, the workflow blocks you from moving forward until it's resolved. Reach out to a Support Specialist if you're not sure how to connect or authenticate your Google Export.

## The workflow at a glance

Creating and assigning a Google Promotion follows a slightly different order than Exclude/Include Products and Custom Labels: you choose your export first, then assign the products, and then define the promotion itself.

| Step                        | What you do                                                                                                                                                             |
| --------------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| **1. Select your export**   | Choose the connected Google export(s) the promotion applies to.                                                                                                         |
| **2. Assign products**      | Find the products to assign by SKU/ID list, or an attribute / product-type filter.                                                                                      |
| **3. Create the promotion** | Fill out the guided form: promotion basics and the fields specific to your shopper incentive. Your changes enter a draft state, and nothing is submitted to Google yet. |
| **4. Review the draft**     | Preview the exact count of products the promotion will be assigned to, per export.                                                                                      |
| **5. Publish**              | Confirm and publish. The assignment is applied, and the promotion is submitted to Google for review.                                                                    |

> **After you publish**
>
> Use the **Manage promotions** tab to track the promotion's status with Google and see any errors. See [Track status and resolve errors](#track-status-and-resolve-errors).

## Select your export

Start by choosing where the promotion will run. Open the **Create promotion** tab (the default view) and set:

* **Exports**: select the Google export(s) this promotion applies to. Only connected Google exports are selectable, and your export's connection status shows inline.
* **Country and Language**: pre-populated from your Google export's data source settings. If a database has more than one Google data source, you choose from a dropdown.

## Assign products to the promotion

With your export selected, search and select the target products the same way you would in Exclude/Include Products or Custom Labels:

* **SKU / ID list**: paste a list directly into the search filter.
* **Attribute or product-type filter**: filter by brand, category, price, or other fields.

## Create the promotion

Fill in the remaining fields Google requires to display the promotion:

* **Promotion title**: a customer-facing name for the promotion.
* **Promotion ID**: a unique identifier. Reuse an existing ID to assign more products to a promotion that's already live, or enter a new one to start a new promotion.
* **Start and end date**: the dates the promotion is live.
* **Promotion marketing methods**: where the promotion applies. Choose online store (with a destinations dropdown), in store, or both.

![The Create promotion tab showing the Exports field with Google connection status, Country and Language, Promotion title, Promotion ID, start and end dates, marketing methods, and a Shopper incentive dropdown.](/_fern-files/_img/c1a738a48e661d1c103ce0a5ef9afcf7ba7dd355b0cdb1ac52de986f51af84d9.webp)

## Choose a shopper incentive

Shopper incentive is how the promotion is structured. Select an incentive type, and the fields below it change to match.

![The Shopper incentive dropdown expanded to show four options: Percent off, Amount off, Free gift, and Free shipping.](/_fern-files/_img/32de81ac0a05426d7096b0f7fe4c520899f0ce6d6665d2581481d1050a88af42.webp)

### Percent off

Enter the percentage off. You can optionally apply the discount to a quantity of items, or limit the maximum amount of money customers can receive.

![The Percent off fields, with a discount percent input and optional settings for a quantity of items or a maximum discount amount.](/_fern-files/_img/866b3c0835137d182b0daaa26888db1e4500b11991af633ae72c8e54355f1de2.webp)

### Amount off

Enter a fixed amount off, and optionally apply the discount to a quantity of items.

![The Amount off fields, with a discount amount input and an optional quantity-of-items checkbox.](/_fern-files/_img/f335a54c1be5e785d3a623a845d952c2a8b1afa742a526dc42ab1d2b83e0b2f5.webp)

### Free gift

Choose the type of gift: gift card or other. A gift card amount is required for gift cards. For other gifts, you can add an optional description.

![The Free gift fields, with a Type of gift selector and a Gift card amount input.](/_fern-files/_img/261b0d548db1d4559d4baceb010959509fbee457cc935bff4471bf322611a8f8.webp)

### Free shipping

Select the delivery option the free shipping applies to: Standard, Overnight, or Two day.

![The Free shipping field, with a delivery option selector offering Standard, Overnight, and Two day.](/_fern-files/_img/aff42b3e1258421dd9771132bc230d0f4523d289ea56b39f81cde1c1175bce0f.webp)

> **Promotion types Google doesn't allow**
>
> Google doesn't allow the following promotion types. A rejected promotion can't be resubmitted, so check this list before you publish.
>
> | Promotion          | Type                                                                                                            | Additional information                                                                                |
> | ------------------ | --------------------------------------------------------------------------------------------------------------- | ----------------------------------------------------------------------------------------------------- |
> | Vague discounts    | Up to y% off or "as much as x saved"                                                                            | Floor discount must be stated.                                                                        |
> | Vague discounts    | x% Cash Back or Reward Points Back                                                                              | Cash back in percent and reward points are not allowed, unless combined with a permissible promotion. |
> | Overly restrictive | x% off for first-time customers                                                                                 | n/a                                                                                                   |
> | Overly restrictive | All promotions restricted to a subset of shoppers (for example, military discounts, birthdays, or PayPal users) | n/a                                                                                                   |
> | Other              | Discounts already reflected on the product landing page                                                         | Discounts must not already be reflected on the product landing page.                                  |
> | Other              | Shipping discounts without a redemption code that aren't combined with a permissible promotion                  | n/a                                                                                                   |
> | Other              | Promotions exceeding a duration of 6 months                                                                     | n/a                                                                                                   |
> | Other              | More than 500 live promotions at once                                                                           | n/a                                                                                                   |

> **Note**
>
> You can have up to 500 open promotions at any given time. If you've reached the open promotions limit, Google won't approve additional promotions.

> **Plan for Google's review time**
>
> You can choose a same-day start date, but because of Google's approval process, Feedonomics can't guarantee a promotion goes live within 24 hours. As a best practice, choose a start date at least 2 days out, per Google's guidance. If you need a promotion to go live in less than 24 hours, set it up directly in Google Merchant Center.

![The Create promotion tab filled out, with a product filter matching products for assignment and the start and end dates set.](/_fern-files/_img/0395bdcca11e1db6cf37c3fa4532c020ce3d4419d343429f03fea6ce3b51f2f2.webp)

Select **Review changes** to move into preview mode.

## Review the draft

The shared draft and preview step confirms the number of products the promotion will be assigned to, broken out per export. Products in export, already-assigned, and newly-assigned counts are shown separately so you can see exactly what will change.

![The Review changes panel showing the promotion name, the total products to be assigned, and a per-export table with products in export, already assigned, newly assigned, and total assigned counts.](/_fern-files/_img/cbb0b9210c87b4d252f17e5b83b48991858c8726f03bea45d610fb068d99b661.webp)

## Publish

Select **Save changes** to apply the assignment and submit the promotion to Google for review.

![A confirmation message stating the promotion was submitted to Google Merchant Center.](/_fern-files/_img/c58e0238a6704e5bb9e231412069cf565929daab088aeca055098a4606fb63a9.webp)

## Track status and resolve errors

Because this workspace connects directly to the Google Merchant API, you don't need to check Google's own console to see where a promotion stands. Google moves every promotion through the following stages, and the platform keeps the status current automatically:

| Status            | What it means                                                                             |
| ----------------- | ----------------------------------------------------------------------------------------- |
| **Policy Review** | Google is reviewing the promotion against its promotions policies. It isn't live yet.     |
| **SKU Review**    | Google is reviewing the specific products/SKUs the promotion is assigned to.              |
| **Live**          | The promotion is approved and running.                                                    |
| **Rejected**      | Google rejected the promotion. The error message is shown on the promotion's detail view. |

> **Rejected promotions can't be resubmitted**
>
> Google doesn't support resubmitting a rejected promotion. If a promotion is rejected, create a new promotion with the corrected details rather than trying to edit and resubmit the old one.

Google's policy and SKU review errors are retrieved through the Merchant API and shown directly on the promotion's detail view in this workspace.

## Manage your promotions

Open the **Manage promotions** tab to see every promotion created for a database, browse by Google export, and check each one's live status.

![The Manage promotions tab listing promotions with the active promotion count, a search field, and columns for Promotion ID, exports, country and language, schedule, created and updated timestamps, rule toggle, exceptions, and Google status.](/_fern-files/_img/fd65a16c715b299be7ea4e0dc18176666aee5f8f0498cdef7ed76ad4996a7860.webp)

* **Active Google promotions**: shows how many promotions are currently active against your account's quota. Google caps the number of active promotions per account.
* **Search**: find a specific promotion by title or Promotion ID.
* **Per-promotion details**: exports, country/language, schedule (start and end dates), and created and last-updated timestamps.
* **View rule / toggle**: view the product-assignment rule behind a promotion, and enable or disable it.
* **Exceptions**: the count of products excluded from this promotion's assignment rule.
* **Google status**: the promotion's live status as reported by Google, for example Live, or Not found in Google Merchant Center while a new promotion is still syncing.

## Get help

Most of what's covered in this guide, such as creating a promotion, assigning it to products, and checking its status, can be done yourself directly in the workspace. If you hit something the workspace can't resolve, a Support Specialist can pick it up from exactly where you left off.

### Select Need Support?

It's at the bottom of the workspace.

### Share what you've done so far

Whatever you've already filled in or drafted is available to share with Support, so you won't need to re-explain your request.

#### [FeedSupport Portal](/product/account/feedsupport-portal)

Submit a request, check on open tickets, and find the Promotions tile.

#### [Custom Labels](/product/workflows/custom-labels)

A sibling self-service workflow that uses the same search-and-select pattern.

#### [Google Merchant Center Help](https://support.google.com/merchants/answer/2906014?hl=en)

Create a promotion for specific products. Describes the same two assignment methods used here: product filters and Promotion ID mapping.

> **Note**
>
> This guide is a general reference. Specific steps or available options may vary slightly depending on your account setup.