# Join

## What are join bonuses?

A join bonus is a reward that customers receive when they sign up for your loyalty program. This bonus serves as an incentive for new users to join the program.

{% hint style="info" %}
If a customer is listed as Pending or Imported they have not yet joined the program. To earn this bonus, they'll need to register for the loyalty program.
{% endhint %}

## How to Add a Join Bonus

Registration bonuses comer pre-loaded in your program, but in the case you need to add it, follow the below steps:

1. **Navigate to the Loyalty Program Settings:** From your Perkville dashboard, locate the "Loyalty Program" option in the left navigation menu and click on it.
2. **Access Earning Activities:** Scroll down to the "Earning Activities" section. This is where you can manage the different ways customers can earn points.
3. **Add a New Join Bonus:** To add a registration bonus, click on the "+" icon within the "Earning Activities" section. This will present you with a menu of different earning activities you can create.
4. **Select the Join Activity:** In the new earning rule setup, choose "Joining" from the list of available activities. This ensures that the bonus will be awarded when a customer registers for your program.
5. **Configure the Bonus:** Enter the number of points you want to offer for registration. You can customize this based on your program’s needs.
6. **Save the Rule:** After configuring the registration bonus, click "Save" to apply the new earning rule to your program. The bonus will now be automatically awarded to customers who register.

## Membership-specific Registration Bonuses

If your program has [membership settings](/features/settings/advanced/membership-settings.md) turned on, you can create tiered join bonuses based on the member's membership type. 

{% hint style="warning" %}
Check with the Perkville team to confirm that your program is importing membership status and type.
{% endhint %}

You will see a toggle for "Membership Restricted." If you toggle this on, you will have additional options to fill out for your join bonus;

* The name of the join bonus
* The number of points
* The list of membership types included in the bonus
* A description for the join bonus

<figure><img src="/files/68KqCYbRYv4moCw0Lo1E" alt=""><figcaption><p>The setup for a membership-restricted join bonus</p></figcaption></figure>

{% hint style="warning" %}
The syntax of the membership type list will need to match the syntax of membership types in your membership system.
{% endhint %}

If you have multiple join bonuses, including a generic join bonus, they will only receive points for one of the bonuses when they register for your loyalty program.


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.perkville.com/features/earning-rules/join.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.