# Promotions Agent

Create and manage promotions using natural language in the Merchant Center.

The Promotions Agent turns plain-text descriptions into Cart Discount, Product Discount, or Discount Code drafts, including complex mechanics like buy-and-get, bundles, spend-and-save, shipping discounts, and gift-with-purchase. It identifies the discount type, scope, and constraints from your input, and resolves the matching Products, Categories, and Customer Groups from your Project—you don't need to build your predicate logic manually.

**AI use:** This feature uses AI to analyze data you provide.

**Your data:** We do not use your data to train models.

**Opt-in:** To enable this feature, submit a [support request](https://support.commercetools.com/) and include the Project key.

## When to use the Promotions Agent

The Promotions Agent is useful when you want to:

- Create Cart Discounts, Product Discounts, or Discount Codes without manually configuring predicates and discount values.
- Explore how to set up a specific type of promotion.
- Update one or multiple existing discounts with one prompt. You can search for existing discounts by their name or key.

## Intended workflow

1. Open the Promotions Agent from the Discounts page.

2. Describe the promotion you want to create in plain text, or use the provided templates to get started.

   Include all the relevant details about the campaign or promotion, such as the eligibility rules, discount value, priority, and validity dates. Based on your description, the agent creates a single discount or multiple discounts as needed.

3. If your prompt is missing necessary information, such as priority or validity date, the agent presents clarifying questions.

4. After you provide the details, the agent presents a draft summarizing the proposed discount.

   To improve readability, the agent uses plain-language labels where necessary; for example, First, Last, Near the top, In the middle, or Near the bottom for the priority field, instead of raw decimal values. The agent also auto-populates the name and description for all Project locales.

5. Save the draft, or refine the draft details (without restarting the session).

   If you refresh the page or reopen the agent pane, all progress (pending approvals and finalized results) from a session is saved.

   When saved, the discount is created in an inactive state and must be activated.

The agent respects your existing user permissions throughout the session.

## Agent instructions

You can add custom instructions for the agent to tailor its suggestions to your business case; for example, you can:

- Use the Discount description field for promotion eligibility communication text.
- Set the default to a specific stacking mode or validity period.
- Set a naming convention or prefix for generated discount names, keys, and Discount Codes.

Custom instructions also let you work around known limitations, such as targeting products by attribute instead of by SKU list.

## Limitations

- Only one Discount Code is generated at a time. To generate in bulk, use the [bulk generator tool](/merchant-center/discount-codes.md#generate-discount-codes) instead.
- Cart Discount predicates cannot target long SKU lists. Use a category or product attribute as the predicate target instead.
- Absolute Product Discounts reduce prices below zero, and require explicit approval before proceeding.

## Related pages

- [Area overview page with navigation](/merchant-center.md)
- [Previous page: Intake Agent](/merchant-center/ai-agents/intake-agent.md)
- [Search documentation and API specs](/search.md)