> For the complete documentation index, see [llms.txt](https://docs.shopwaive.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.shopwaive.com/shopify/loyalty/all-settings.md).

# More settings

The settings in More settings on the Loyalty page: how orders earn, when points are added, campaigns, the other ways to earn and the program's words, with the values Start blank begins with

Every setting below is in **More settings** on the [Loyalty page](https://docs.shopwaive.com/shopify/loyalty.md). Open **More settings**, then the section you want: each one stays closed until you open it, and only the sections your program uses are listed. A ready program fills them in for you, and you can change them later. The starting values named here are those of **Start blank**.

Some settings and choices on the Loyalty page are greyed out. They do not work, and your program runs without them, so this page leaves them out. If your program saved one of them before, the page lists it and says the version cannot run. Change it and save: until then, that version does not run.

While your program is in **Test**, **Preview on real orders** or **Live**, **Save and apply** saves a new version and applies it to your program. If a setting in it cannot run, the page says the version is saved and not running, and your program keeps running the version before. **Save draft** keeps your changes without making a version.

Below the settings, **Status and testing** holds the program status, and **Versions** lists every saved version of your program. **Restore** makes an earlier version the newest.

<figure><img src="https://1743155819-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F6HSAZj4RDucpQwVtzMYt%2Fuploads%2Fgit-blob-de06a99a050630bf492fee6308d9d3b59afabcea%2Fapp-loyalty-status.jpg?alt=media" alt="More settings: Status and testing, with the checks before you go Live"><figcaption><p>Status and testing</p></figcaption></figure>

## Earn <a href="#earn" id="earn"></a>

<figure><img src="https://1743155819-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F6HSAZj4RDucpQwVtzMYt%2Fuploads%2Fgit-blob-0e2761b3438b057c839b3d3967aa4622cf57ab35%2Fapp-loyalty-more-settings.jpg?alt=media" alt="More settings on the Loyalty page: the Earn section, open, with Earn rate, Points and the rest"><figcaption><p>More settings, with Earn open</p></figcaption></figure>

| Setting                                                | What it does                                                                                                                                                                                                                                                                                                                                                     | Starts as                  |
| ------------------------------------------------------ | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | -------------------------- |
| **Orders earn**                                        | Whether orders earn at all. Once your program has run, it stays on.                                                                                                                                                                                                                                                                                              | On                         |
| **Earn rate**                                          | **Points for every amount spent** or **A fixed number of points per order**. **A percentage back** pays money, so it is greyed out, with the reason under the field. At a store that keeps each balance in money, the points rates are greyed out too. A version saved with **A percentage back** before keeps it as its value, with the reason under the field. | 5 points for every 1 spent |
| **Part units**                                         | Whether part of an amount earns its share (**Count them**) or only whole steps earn (**Whole steps only**).                                                                                                                                                                                                                                                      | Count them                 |
| **Shipping earns**, **Taxes earn**, **Duties earn**    | The amount that earns is the items after discounts. Tick these to add shipping, taxes or duties.                                                                                                                                                                                                                                                                 | Off                        |
| **The part paid with points or balance**               | The part of an order paid with the customer's balance earns no points.                                                                                                                                                                                                                                                                                           | Does not earn              |
| **The part paid with a gift card**                     | The part of an order paid with a gift card earns, as any payment does.                                                                                                                                                                                                                                                                                           | Earns                      |
| **Buying a gift card**                                 | Whether buying a gift card earns. A gift card earns when it is spent, so the same money never earns twice. **Live** needs **Does not earn**.                                                                                                                                                                                                                     | Does not earn              |
| **Order currency**                                     | Earn on the store's currency, or on the currency the shopper paid in.                                                                                                                                                                                                                                                                                            | The store's currency       |
| **Smallest order that earns**                          | An amount. Empty for none.                                                                                                                                                                                                                                                                                                                                       | None                       |
| **Most points for one order**                          | A number. Empty for none.                                                                                                                                                                                                                                                                                                                                        | None                       |
| **Sales channels that do not earn**                    | Shopify's channel names, separated by commas, for example `pos` or `shopify_draft_order`.                                                                                                                                                                                                                                                                        | All channels earn          |
| **A different rate by channel**                        | A multiplier per channel, for example `pos=1.5`.                                                                                                                                                                                                                                                                                                                 | None                       |
| **Order tags** and **Discount codes that do not earn** | Leave these out of earning, separated by commas.                                                                                                                                                                                                                                                                                                                 | None                       |

## When points are added <a href="#when-points-are-added" id="when-points-are-added"></a>

| Setting                                  | What it does                                                                                                                                                                            | Starts as                     |
| ---------------------------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ----------------------------- |
| **Points are added when**                | **The order is paid**, **The order is fulfilled** or **The order is delivered**.                                                                                                        | The order is paid             |
| **How we know it was delivered**         | With delivery: Shopify's delivery status, an order metafield with a value you name, or an order tag you name. Shopwaive never guesses a metafield or tag: name the one your store sets. | Shopify's delivery status     |
| **Then wait (days)**                     | 0 to 120 days after that moment. Use your return window.                                                                                                                                | 0                             |
| **If delivery is never recorded**        | Add the points a number of days after fulfilment, keep waiting, or never add them.                                                                                                      | 30 days after fulfilment      |
| **Orders with nothing to ship**          | Earn when paid, or follow the rule above.                                                                                                                                               | Earn when paid                |
| **A refund before the points are added** | **Lowers the waiting points**, or **Is ignored**.                                                                                                                                       | Lowers the waiting points     |
| **Points expire**                        | See [Expiry](https://docs.shopwaive.com/shopify/loyalty/redeem-expiry-and-refunds.md#expiry).                                                                                           | 365 days after they are added |

While an order waits, customers see its points as on the way, for example "25 points on the way: added when your order is delivered" on their order in customer accounts.

## Campaigns <a href="#campaigns" id="campaigns"></a>

A campaign gives bonus points for a time. Several can run at once, and each order is judged on the time it was placed. You can add up to 50.

For each campaign, set:

* **Runs from** and **Until**, in UTC. Leave **Until** empty for no end.
* **Bonus**: **Multiply the points**, **Extra points per order** or **Extra points for every amount spent**.
* Which orders it applies to: only some sales channels, or only orders over an amount.
* **Most bonus points for one order**: empty for none.

**When two campaigns match** decides whether the better one applies (the starting value) or both are added together.

## Other ways to earn <a href="#other-ways-to-earn" id="other-ways-to-earn"></a>

Each card is off until you switch it on, and every reward is paid once.

* **Joining**: points for each new customer with an email, a guest at checkout included, once. Customers who were your customers before your program went Live get none. The ready programs switch it on, with **A customer joins when** set to **An account is created** and **Paid** set to **At once**. With **Start blank**, **A customer joins when** starts at a greyed-out choice: choose **An account is created** when you switch Joining on.
* **Anniversary**: points every year on the day a member joined your program, from the year after they joined.

Joining and anniversary points are paid while your program is **Live**. In **Test**, only orders earn.

Unless your store uses **Multiple expiry dates** (under **Settings** > **Balances** > **Expiration**), it keeps one expiry date for each customer's whole balance, so a joining or anniversary reward's **These points expire** must be **As earned points**, its starting value. **Never** and **After a number of days** are then greyed out, with "Your store keeps one expiry date for each customer's whole balance, so these points expire as earned points do." under the setting.

## Rewards <a href="#rewards" id="rewards"></a>

* **Rewards**: up to five **Milestones**, each a number of points with a label, as goals shoppers see. What points are worth is set on step 2 of the Loyalty page: see [What points are worth](https://docs.shopwaive.com/shopify/loyalty/redeem-expiry-and-refunds.md#what-points-are-worth).

To email customers when they earn, build a Klaviyo flow on the `Shopwaive: Balance Earned` event: see [Emails when customers earn](https://docs.shopwaive.com/shopify/loyalty.md#emails-when-customers-earn). Your store connects Klaviyo once, with one key, under **Settings** > **Integrations**: see [Klaviyo events](https://docs.shopwaive.com/shopify/email-and-campaigns/klaviyo-events.md).

Shopwaive keeps the points of each order on the order in Shopify. Shopwaive never reads that field back to decide anything.

## Program <a href="#program" id="program"></a>

| Setting                                        | What it does                                                                                                                                                                                                                                                                                                                                               | Starts as                                                |
| ---------------------------------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | -------------------------------------------------------- |
| **Who can join**                               | **Every customer with an email**.                                                                                                                                                                                                                                                                                                                          | Every customer with an email                             |
| **Customers with no email**                    | Points are paid only to a customer with an email on file. With **Points are paid if an email is added before they are due**, an order whose points are not due yet earns if the customer has an email by the time they are due, for example after delivery and its wait. With **Not earned**, such an order earns nothing while the customer has no email. | Points are paid if an email is added before they are due |
| **Leave out company customers**                | Company customers earn nothing. It cannot be switched on while a joining, birthday or anniversary reward is on.                                                                                                                                                                                                                                            | Off                                                      |
| **Rounding**, **Decimals**                     | How points are rounded: nearest, down or up, to 0, 1 or 2 decimals.                                                                                                                                                                                                                                                                                        | Nearest whole point                                      |
| **Program name**                               | What shoppers see.                                                                                                                                                                                                                                                                                                                                         | Your store name followed by Rewards                      |
| **Points name, one** and **Points name, many** | For example point and points.                                                                                                                                                                                                                                                                                                                              | point, points                                            |
| **The note of an earning**                     | The words around the number in the customer's history, for example "Earned " before the number and " points" after it.                                                                                                                                                                                                                                     | Earned 12 points                                         |

Some words become part of your customers' points history once points are paid with them, such as the note of an earning. After that, Shopwaive keeps them exactly as they are, so the same order is never paid twice. If a change would alter one of them, **Save** explains which one and saves nothing.
