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

# Create a bonus

> Build a bonus inside a campaign, one tab of the form at a time, from an empty form to published.

Use a bonus to give customers extra bonus while it runs. This page takes you through creating one in Lobyco Nexus, from an empty form to published.

> [!NOTE]
>
> A bonus always belongs to a campaign, so create or open the campaign first.

## Add a bonus to your campaign

1. Go to **Campaigns** and open the campaign the bonus belongs to, or [create a new one](/business-documentation/campaigns/create-a-campaign).
2. Select **Add activity**.
3. On the **Select an activity** page, point at the **Bonus** tile and select **From scratch**. To start from a saved bonus instead, select **From template**. [Reuse with templates](/business-documentation/campaigns/reuse-with-templates) explains how.

![The Select an activity page, opened with Add activity from the campaign Autumn bonus weeks, under the heading Select an activity and the line Which type of activity best suits your promotional needs? Nine tiles are in view: Bonus, Challenge, Game and Email in the first row, Offer, Banner, Feed and Prompt in the second, and Push in the third. Each tile has an icon, a Promotion, Offer or Communication badge and a short description. The pointer is on the Bonus tile, which is raised, with its text blurred behind the heading Create activity and two buttons, From template and From scratch. The heading These activities are not available starts below the tiles.](https://mintcdn.com/lobyco-4c9fb3ad/rG971_5ZfS49bcjM/images/bonuses-01-select-an-activity.png?fit=max\&auto=format\&n=rG971_5ZfS49bcjM\&q=85\&s=814793472287bc9cdacd059c48476e7f)

*The Select an activity page, with the pointer on the Bonus tile*

The form has three tabs, in this order: **Activity details**, **Activity behaviour** and **Segmentation**. A red number on a tab means something on it still needs filling in. A tick means the tab is complete.

![The bonus form as it opens from Add activity, headed Bonus. Three numbered tabs run across the top in this order: 1 Activity details, which is open and has a red number, then 2 Activity behaviour and 3 Segmentation. The Details panel shows Select bonus type, Activity name with Example: Bonus week 1 under it, Start date and End date, Sponsor, and Chain(s) OR Store(s), each with an upload icon. Every field is empty. Under the chains and stores is the hint Choose either chains or stores where bonus can be earned, but not both simultaneously. At the bottom are Cancel, and Save and Publish, which are both greyed out.](https://mintcdn.com/lobyco-4c9fb3ad/rG971_5ZfS49bcjM/images/bonuses-02-bonus-form-as-it-opens.png?fit=max\&auto=format\&n=rG971_5ZfS49bcjM\&q=85\&s=faca13ca81a6988442b1929e7d2fd978)

*The bonus form as it opens, on Activity details*

## Fill in Activity details

Start by picking the bonus type. It decides how the extra bonus is worked out, and which fields the next tab shows. [Bonus types](/business-documentation/activities/bonuses/bonus-types) explains each one.

| Field | What it does |
| - | - |
| **Select bonus type** | Sets the kind of bonus: **Product Bonus**, **Basket Bonus**, **Local Bonus**, **Multiplier Bonus** or **Redemption Bonus**. |
| **Activity name** | Names the bonus in Nexus, for example *Bonus week 1*. |
| **Start date** / **End date** | Set when customers can earn the bonus. Both start out empty, and they have to stay inside the campaign's dates. |
| **No end date** | Keeps the bonus running until you stop it. Shows for **Local Bonus** only. |
| **Sponsor** | Optional. Records who pays for the bonus, for example **Retailer** or **Supplier**. The choices are set up for your organisation, and the field only shows when there are some. |
| **Chain(s)** or **Store(s)** | Sets where customers can earn the bonus. Pick chains or stores, not both. Choosing one turns the other off. To add a long list, use the upload icon beside the field and pick a .csv file with one chain or store ID on each line. The upload replaces any chains or stores you've already picked. Nexus skips any ID it doesn't recognise, and tells you how many it added. |

A **Redemption Bonus** has no dates, chains or stores on this tab. Its dates are on the next tab. It isn't tied to a chain or store, because it's based on the customer's balance, not on a purchase. If you switch to **Redemption Bonus** after filling in this tab, the dates, chains, stores and sponsor are cleared.

## Set how the bonus behaves

Open **Activity behaviour**. For every type except **Redemption Bonus**, the tab starts with these fields.

| Field | What it does |
| - | - |
| **Select week days** | Sets the days customers can earn the bonus. **Everyday** is ticked to start with. Untick it to pick single days. |
| **From** / **To** | Optional. Limit earning to a time of day on those days, for example a happy hour. Fill in both or neither. **To** has to be after **From**. |
| **Redemption start date** | Optional. The first day customers can spend the bonus they earn here. It has to be after the bonus's start date. |
| **Redemption expire date** | Optional. The day the bonus they earn here expires. It has to be after the bonus's end date. |

Leave both redemption dates empty and the bonus works like any other bonus the customer earns.

Below these, the tab shows the fields for your bonus type. A **Redemption Bonus** shows only its two redemption dates and the **Redemption bonus** field, which sets the percentage of the balance to add. Its redemption dates are required, and they set when the extra bonus is added and when it expires. Bonus types lists the fields for a [Product Bonus](/business-documentation/activities/bonuses/bonus-types#product-bonus), [Basket Bonus](/business-documentation/activities/bonuses/bonus-types#basket-bonus), [Local Bonus](/business-documentation/activities/bonuses/bonus-types#local-bonus), [Multiplier Bonus](/business-documentation/activities/bonuses/bonus-types#multiplier-bonus) and [Redemption Bonus](/business-documentation/activities/bonuses/bonus-types#redemption-bonus).

## Choose who gets the bonus

Open **Segmentation**.

| Option | What it does |
| - | - |
| **All members** | Every customer can earn the bonus. This is selected to start with. |
| **Target only selected segments** | Only customers in the audiences you pick can earn it. |

When you choose **Target only selected segments**, more options open:

* Turn on **Exclude Audiences** to leave out the customers in the audiences you pick. Everyone else can earn the bonus.
* **Select Audience** picks saved audiences. Select **Select from list** to choose one, or **Create new audience** to make one.
* **Select Snapshots** picks a snapshot of an audience instead. A snapshot is a copy of the audience at one moment, so its customers don't change after that.

![The Segmentation tab of the bonus form. Activity details and Activity behaviour both show a tick, and Segmentation is open with a red number. Target only selected segments is selected instead of All members. Under it are the Exclude Audiences switch, which is off, and two options: Select Audience, which is selected and has the buttons Select from list and Create new audience, and Select Snapshots. At the bottom are Cancel, Save, and Publish, which is greyed out.](https://mintcdn.com/lobyco-4c9fb3ad/rG971_5ZfS49bcjM/images/bonuses-03-segmentation-selected-segments.png?fit=max\&auto=format\&n=rG971_5ZfS49bcjM\&q=85\&s=6a3d396990c6e1c4b6d801631f3ff350)

*Segmentation, with Target only selected segments chosen*

## Save or publish the bonus

* **Save** keeps the bonus as a draft. It stays greyed out until the bonus has a bonus type, a name and its dates.
* **Publish** stays greyed out until every required field on all three tabs is filled in. Nexus asks you to confirm first.

If either button is greyed out, look for a tab with a red number. That's where something is still missing.

Select **Publish**. In the dialog that opens, select **Publish now** if the start date and time have already passed. The bonus goes live straight away. If it starts later, select **Publish** there, and it goes live on its start date and time.

You'll know it worked when the bonus shows in the campaign's activity list as **Active** or **Scheduled**.

## Troubleshooting

> **Why is my product file rejected?**
>
> It doesn't match the layout for its field. Bonus types shows the layout for a [Product Bonus](/business-documentation/activities/bonuses/bonus-types#product-bonus) file, and for the include or exclude files on a [Basket Bonus](/business-documentation/activities/bonuses/bonus-types#basket-bonus) or [Local Bonus](/business-documentation/activities/bonuses/bonus-types#local-bonus).

> **Why won't my Product Bonus save?**
>
> Another published **Product Bonus** already gives a different bonus on the same product, in the same chain or store, at the same time. Change the dates, the products, or the chains or stores so they don't meet. Or give the product the same bonus in both.

## Related

* [Bonus types](/business-documentation/activities/bonuses/bonus-types) — what each bonus type gives the customer, and its fields in full.
* [Edit, unpublish or reuse a bonus](/business-documentation/activities/bonuses/edit-unpublish-or-reuse-a-bonus) — what you can still change once the bonus is live.
* [Reuse with templates](/business-documentation/campaigns/reuse-with-templates) — start a new bonus from a saved one.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.