Campaigns

A campaign is your rule for when and what to offer. You can run as many as you like; for any single order the highest-priority matching campaign wins and only that one offer is shown (see Choosing the offer).

Go to the Campaigns tab and click Add campaign. The form is split into cards.

Card: General

• Internal name: A name just for you, to recognise the campaign in the list. Customers never see it. Required.
• Active: Turn the campaign on or off without deleting it.
• Valid from: Optional. The offer is not shown before this date and time. Leave empty to start immediately.
• Valid until: Optional. The offer is not shown after this date and time. Leave empty for no end date.
• Priority: When more than one campaign matches an order, the one with the highest priority is shown. Higher number wins.
• Sales channels: The offer is shown only in the selected sales channels. Leave empty and the campaign runs in no channel. New campaigns start with all channels selected.

Card: When to show

This card decides which orders qualify.

• Trigger: What kind of order triggers the offer: Always (any order), Only if a specific product was bought, Only if a product from a category was bought, or Only if a product from a manufacturer was bought.
• Trigger product / category / manufacturer: Appears once you pick the matching trigger. Choose what must be in the order. Variants are matched against their main product, so picking a configurable product covers all its variants.
• Excluded products (do not trigger): If any of these products (or one of their variants) is already in the order, the offer is not shown, so you never offer something the customer already bought.
• Min order value: Only show when the net value of the ordered items (line items only, excluding tax and shipping) is at least this. Leave empty for no minimum.
• Max order value: The same, as an upper limit. Leave empty for no maximum.
• Customer groups: Only show for these customer groups. Leave empty for all.
• Shipping countries: Only show for orders shipping to these countries. Leave empty for all.

Card: The offer

This card decides what is offered and at what price.

• Offered product: The product the customer can add. Required.
• Quantity to add: How many units are added on accept. Default 1. The actual quantity is clamped to the product’s minimum/maximum purchase and purchase-step settings.
• Discount type:No discount, Percentage, or Absolute amount.
• Discount value: Percent off (percentage), or a fixed amount off the product’s price (absolute). The absolute value is applied as-is to the displayed unit price: there is no currency conversion. Hidden when the discount type is “No discount”.
• Headline: The short line above the product on the offer page. A friendly default is used if you leave it empty. Translatable per language.
• Button text: The text on the accept button. A sensible default is used if you leave it empty. Translatable per language.

Card: Payment & order handling

This card controls when it is safe to add the item, based on payment and documents.

• Allowed payment methods: The offer only appears for orders paid with one of these methods. Only methods the upsell can apply on are listed (invoice, prepayment, cash on delivery, direct debit and PayPal). Leave empty and the campaign never runs. New campaigns start with all supported methods selected.
• Document policy: What to do if the order already has documents (such as an invoice) when the customer accepts. See below.
• Shipping policy: Whether the offer may change the order’s shipping cost. See below.
• Stock policy: Whether the offered product needs available stock before it is shown. See below.

Document policy

• Block if a document already exists (safest): the item is not added if the order already has any document. Default: avoids invoices that no longer match the order.
• Block only if an invoice exists: added unless an invoice exists; other documents (e.g. delivery notes) are ignored.
• Add item, notify admin to regenerate documents: the item is added anyway. If the order already has an invoice, the order is flagged and (if a shop email is configured) an email is sent to your shop address so you can recreate it. See Emails.

Shipping policy

• Only if shipping stays the same: shows the offer unless adding the product would change the order’s shipping total. Shipping-free products always qualify.
• Shipping-free products only: restricts the offer to products that never ship (e.g. digital goods).
• Offer anyway (keep original shipping): shows any product, without applying the shipping-change check.

Stock policy

• Require available stock (default): offered only if enough stock is available.
• Follow Shopware oversale config: follows Shopware’s own rules (clearance products need stock, others can be oversold).
• Ignore stock (advanced): always offered, even when out of stock.

Card: Offer page layout

By default the offer uses the plugin’s built-in page, which works out of the box. This built-in page uses the same standalone recommended-add-on design as the Post-purchase offer Shopping Experience, but it is not editable.

To control the look, assign a Post-purchase offer or Post-purchase bundle offer layout from Shopping Experiences. The bundle layout adds the product already in the order on the left, when the campaign has a product trigger. See Offer page design.

Editing a live campaign