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

# Loyalty

> Reward customers with points they redeem in OneMove.

Loyalty is how you reward customers with points they redeem in **OneMove**. You design programmes in the Dashboard; residents see and spend points in the app.

You can view Loyalty from the [Loyalty page](https://dashboard.yorlet.com/loyalty).

## Enable Loyalty

Loyalty is a pay-as-you-go add-on. To enable it, follow these steps:

1. Go to [Your plans](https://dashboard.yorlet.com/settings/plans).
2. Find **Loyalty** and click **Get started**.
3. Complete checkout.

Once enabled, **Loyalty** appears in the sidebar, with **Messages**, **Programmes**, **Residents**, and **Tiers** underneath. You are billed a percentage of loyalty spend when points are redeemed, not when they are granted, and **£0.02** for each message sent. See [list pricing](https://www.yorlet.com/pricing#loyalty).

<Note>You need the admin role to enable Loyalty.</Note>

## How it fits together

A **programme** is the rule: the occasion, the points, and who can receive them. When someone qualifies, Yorlet creates a grant — automatically, from **Add usage**, from a [workflow](/loyalty/grant-with-a-workflow), or from the [API](/development/integrations/loyalty/grant-rewards). Points then appear in OneMove, where the resident can redeem them.

You are billed when points are redeemed, not when they are granted.

## Automatic vs manual grants

For **Rent on time**, **New lease**, **Move in**, **Renewal**, **Tenure milestone**, and **Birthday**, turn on **Grant automatically** when you create the programme. Yorlet grants when that occasion happens.

**In person** uses the check-in QR code on the programme — that grant is already automatic.

**Custom**, **One time**, and **Referral** have no built-in trigger. Grant them with [a workflow](/loyalty/grant-with-a-workflow), **Add usage**, or the [API](/development/integrations/loyalty/grant-rewards).

Programme **Type** still describes the occasion. With **Grant automatically** on, Yorlet grants when that occasion happens. Otherwise grants happen via **Add usage**, a workflow, or the API.

## Points

200 points = £1. The Dashboard shows this conversion when you set reward points.

Points cannot be spent for **5 business days** after they are earned. Redemption happens in OneMove as a rent discount, rent credit, or cash.

## Messages

[Messages](/loyalty/messages) send a OneMove push notification, an email, or both to a building or a customer. Categorised building broadcasts also appear on the noticeboard in OneMove. Successful sends are billed at **£0.02** each.

## The Loyalty page

The [Loyalty page](https://dashboard.yorlet.com/loyalty) shows charts for points earned, points redeemed, residents, and messages. Use the date range to change the period.

## Programme statuses

Every programme has a status:

* **Active**: The programme can be used.
* **Expired**: The expiry date has passed. It cannot be used.
* **Consumed**: The programme has reached its maximum redemptions. It cannot be used.
* **Archived**: You archived it. It is hidden from customers and cannot be used.

The [Loyalty programmes](https://dashboard.yorlet.com/loyalty/programs) page has a tab for each status.

## Get started

<CardGroup cols={2}>
  <Card title="Programmes" icon="hand-holding-heart" iconType="duotone" color="#6366f1" href="/loyalty/programs">
    Create programmes and choose when points are granted
  </Card>

  <Card title="Grant points with a workflow" icon="diagram-project" iconType="duotone" color="#6366f1" href="/loyalty/grant-with-a-workflow">
    Award a custom programme when something happens in Yorlet or another system
  </Card>

  <Card title="Tiers" icon="layer-group" iconType="duotone" color="#6366f1" href="/loyalty/tiers">
    Group residents and restrict programmes to a tier
  </Card>

  <Card title="Residents" icon="users" iconType="duotone" color="#6366f1" href="/loyalty/residents">
    Connect customers to OneMove from tenancies or by hand
  </Card>

  <Card title="Messages" icon="message" iconType="duotone" color="#6366f1" href="/loyalty/messages">
    Send push notifications and emails to residents
  </Card>
</CardGroup>