For the complete documentation index, see llms.txt. This page is also available as Markdown.

Managing rewards (admin)

Rewards are created and managed in the admin backend under Bonus Points & Loyalty Program → Rewards.

Creating a reward

1

Click New reward

2

Fill in the required fields

Enter the name, type, and required points.

3

Save

General

  • Name (required, language-dependent) – title of the reward in the customer account

  • Description (optional, language-dependent) – shown in the customer account below the reward

  • Image (optional) – preview image/icon for the reward tile in the customer account

Settings

  • Type – voucher, free product or free shipping (see reward types below)

  • Required points – how many points the customer needs to redeem

  • Sales channels (empty = all) – restricts the reward to specific sales channels (e.g. storefront only). Leave empty so the reward is available in all channels.

  • Product group (free selection) – only for the free product type: dynamic product group (product stream) from which the customer can select a product on redemption

  • Active – shows/hides the reward without deleting it

Reward types

Voucher

The plugin automatically generates a unique Shopware promotion code.

Requirement: An active Shopware promotion (with individual code mode) must be linked, with an assigned product stream.

Fields:

  • Reward name

  • Required points

  • Linked Shopware promotion

  • Description (optional, shown in the customer account)

Free product

The customer selects a product from a product stream and receives it free in the cart, together with a 100% discount code.

Fields:

  • Reward name

  • Required points

  • Product stream (which products are available for selection)

  • Linked Shopware promotion (for the free code)

Products with variants are automatically shown as individual variants (e.g. "T-shirt (Size: M)"). The customer selects the desired variant.

Free shipping

A free-shipping code is issued to the customer.

Fields:

  • Reward name

  • Required points

  • Linked Shopware promotion (must include shipping cost exemption)

Restrictions

Optional rules to prevent abuse:

  • Max. redemptions per customer (0 = unlimited) – limits how often a single customer can redeem the same reward

  • Cooldown in days (0 = none) – waiting period before the same customer can redeem the reward again

  • Valid from / Valid until – time frame in which the reward can be redeemed at all (time zone: Europe/Berlin). Leave empty for unlimited availability.

Linked promotion

For the voucher and free product types, a Shopware promotion with the "Individual codes" option enabled must be created in advance and selected here. On every redemption, the plugin automatically generates a unique code from this promotion and assigns it to the customer.

As long as no promotion is linked, a warning is shown; after a successful link, the field shows a confirmation ("Promotion linked — codes are generated automatically on redemption.").

Activating / deactivating a reward

Using the Active toggle, a reward can be shown or hidden at any time without deleting it.

Deleting a reward