> ## Documentation Index
> Fetch the complete documentation index at: https://partner-integrations.voyado.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Assign promotions

**General Settings**, **Cart and Order Conditions**, and **Discount Rules** are managed within Shopware itself. You must therefore first create your promotion in Shopware before syncing it with Engage and assigning it to your customer base.

Once the promotion is assigned to one or more customers, they must log into their account to access the discount. During the login process, Shopware assigns the promotion by linking the customer to a Rule using their `externalId` in Voyado Engage, which corresponds to their `Customer ID` in Shopware.

If you plan to run a promotion campaign that can be reused, we strongly recommend creating the assignment directly in **Shopware**.

If a customer creates an account in two different sales channels using the same email address, and both are connected to the same Voyado Engage environment, the promotion will only be linked to the `externalId` generated during the first account creation.

If a personal promotion has been assigned in Shopware and redeemed through a third-party system (POS), it will remain active in Shopware.

## Create and sync a promotion

<Steps>
  <Step title="Create promotion in Shopware">
    1. Log into your Shopware store
    2. Navigate to **Marketing > Promotions**
    3. Select **Add Promotion**
  </Step>

  <Step title="Configure General Settings">
    1. **Promotion Name:** Enter a name for the promotion
    2. **Priority:** Set the desired priority
    3. **Valid From:** Choose a start date

    <Tip>
      If you don't set a start date, the promotion will not be synced to Engage
    </Tip>

    4. **Valid Until:** Set this to unlimited
    5. **Max. Total Uses:** Set this to unlimited
    6. **Max. Uses Per Customer:** Set to 1 to minimize the risk of abuse. This extra validation assures the promotion can only be used once per customer.
    7. Activate the promotion.
    8. Select **Save**.
  </Step>

  <Step title="Add a Promotion Code">
    In the **Promotion Codes** section:

    1. Select "Fixed promotion code"
    2. Enter your promotion code

    <Warning>
      Discount codes used with Engage can only contain:

      * **A-Z, a-z**.
      * **0-9**.
      * **Underscore (\_)**
      * **Hyphen (-)**.
      * **Percentage sign (%)**
    </Warning>
  </Step>

  <Step title="Define promotion conditions">
    Go to the **Conditions** tab and configure:

    1. **Pre-conditions**: Define any necessary pre-requirements.
    2. **Shopping Cart & Order Rules**: Enter the desired conditions under **Rule-based conditions.**

    Do NOT set any Customer rules; Engage will manage these when assigning the promotion.
  </Step>

  <Step title="Set Up Discounts">
    * Go to the **Discounts** tab and:
    * Define the discount logic (e.g., percentage, fixed amount, or free shipping).
    * Click **Save**.
  </Step>

  <Step title="Sync promotion to Engage">
    1. Navigate to **Marketing** **Voyado Configuration**
    2. Select on the **Promotion Sync-up** tab
    3. In the **Sales Channel List**, select the Sales Channel linked to the promotion
    4. Mark the promotions you want to sync to Engage
    5. Select **Sync Promotions**
  </Step>

  <Step title="Finalizing in Engage">
    The promotion will now be created in Engage as a Draft Promotion. It can then be activated and assigned manually or via the Automation tool.

    Once assigned in Engage, eligible customers will be able to use the promotion when they log into their account by applying the code in the discount code field.
  </Step>
</Steps>