WooCommerce: setting up and redeeming rewards

With the Leat plugin for WordPress, the rewards you create in Leat show up in your WooCommerce shop as spend rules. Contacts redeem them for a WooCommerce coupon code that they use at checkout.

How rewards get into WordPress

When you first connect your API key and shop, your rewards are pulled into WordPress automatically. After that, changes you save to an existing reward in the dashboard are picked up automatically, but a new reward has to be imported by hand.

To import new rewards:

1. In your WordPress admin, go to Leat and open the Spend Rules tab.
2. Expand Advanced, and in the Import rewards card click Import now.
3. Wait a moment for it to finish. Your rewards show up in the spend rules list.

The import pulls every reward from Leat and creates or updates the matching spend rules in WordPress. A spend rule whose reward no longer exists in Leat is removed.

Run an import every time you add a reward in the dashboard. WordPress won't pick up new rewards on its own.

When you update an existing reward in Leat, its title, points cost and image are updated in WordPress, but its status and any settings you've made in WordPress stay as they are.

Why rewards are inactive after an import

A newly imported reward lands in WordPress as a draft, so contacts can't see it yet. This is on purpose: a new reward might need a minimum purchase amount before it's ready. Open each new reward after an import and check its settings.

Configuring a reward

Click a reward in the spend rules list to open its settings. Each spend rule controls how the coupon behaves when a contact redeems it. Which settings you see depends on the reward's Type:

• Internal title: the reward name, synced from Leat. Contacts don't see it; they see the label.
• Label: the text shown to contacts on the reward card.
• Description: a short explanation of what the reward offers.
• Discount type: whether the coupon takes off a percentage or a fixed amount.
• Discount value: the size of the discount.
• Minimum purchase amount: the minimum cart total for the coupon to apply. Set it to 50, for example, and the coupon won't work on orders under €50.
• Status: whether contacts can see the reward (Active) or not (Inactive).

The points cost lives in Leat, not in WordPress. To change what a reward costs, update it in the dashboard. The new cost comes through automatically, or with your next import.

Activating a reward

1. Open the Spend Rules tab under Leat.
2. Click the reward you want to activate.
3. Change Status from Inactive to Active.
4. Click Save.

For an inactive reward, Save and activate does both in one click. In the spend rules list, active rewards are marked Published and inactive ones Draft.

The reward then appears on your loyalty dashboard for every enrolled contact who has enough points to claim it.

To take a reward offline, set Status to Inactive and save. It disappears from the dashboard straight away, and its settings are kept.

How contacts redeem a reward

A contact with enough points goes to your loyalty dashboard, finds the reward in the Spend Rules List and clicks Redeem. The points are deducted from their balance and WordPress creates a unique WooCommerce coupon code for them.

That coupon works like any other WooCommerce coupon: they enter it at checkout and the discount applies. The code also stays on their dashboard, so they can copy it whenever they're ready.

Contacts who don't have enough points yet see a progress bar showing how close they are.

The Spend Rules List block

The Spend Rules List is a Gutenberg block that shows your active rewards on any page. Add it to your loyalty dashboard page so contacts can browse what's available and redeem a reward without leaving the page. Each reward appears as a card, and after Redeem the block shows the new coupon code on screen.

Settings you can change in the block editor:

• Grid Columns: how many reward cards appear per row.
• Progress Meter Text: the message for contacts who are close but not there yet, with placeholders like {{current_balance}} and {{required_credits}}.
• Button labels: your own text for the redeem, sign-in and join-program buttons.
• Empty State Message: what contacts see when there are no active rewards.

The Coupons List block

The Coupons List block shows contacts the coupons they've already claimed, with the reward details and a code they can copy. Put it next to the Spend Rules List on your dashboard page, so contacts see both what they can claim and what's waiting for them.

Both blocks show the same thing to the same people. Logged-out visitors see a sign-in prompt, shoppers who haven't joined your program see an invitation to join, and enrolled contacts see their rewards and coupons.