> For the complete documentation index, see [llms.txt](https://docs.perkville.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.perkville.com/features/earning-rules/join.md).

# Join

Learn about join bonuses and membership-restricted join bonuses

## 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.

Joining the loyalty program is different from signing up for a membership at your business. A membership purchase alone does not award this join bonus.

{% 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

Your program comes with a join bonus. To add another bonus:

1. Open **Loyalty Program** from your Perkville dashboard.
2. In **Earning Activities**, click **+** and select **Joining**.
3. Keep the default title or enter a title for this bonus.
4. Under **Qualifying customers earn**, choose points, an [instant reward](https://docs.perkville.com/features/redeeming-rules/instant-rewards.md), or both.
5. Add an optional description, then configure category and display order as needed.
6. If membership features are enabled and you want to limit eligibility, turn on **Restrict by membership type** at the bottom of the form and select one or more existing membership type names.
7. Click **Save**.

The title, rewards, and description fields are available whether or not you restrict the bonus by membership type.

## Membership-specific Join Bonuses

If [membership features](https://docs.perkville.com/features/settings/memberships/settings.md) are enabled under **Settings → Memberships → Settings**, you can create join bonuses for specific membership types.

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

Turn on **Restrict by membership type** and select the names that qualify for the bonus. The same name cannot be assigned to multiple active restricted join bonuses.

<figure><img src="https://2181708597-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FSiE75SeColbiBVbet0NZ%2Fuploads%2Fgit-blob-0f1e64ca9450ee1d34156cb4309c389e028973b5%2Fmembership-restricted-join-bonus.png?alt=media" alt="Join bonus form with Restrict by membership type enabled and Basic selected"><figcaption><p>A join bonus restricted to customers with a Basic membership.</p></figcaption></figure>

Join bonuses use the customer's [selected membership](https://docs.perkville.com/features/customers/memberships.md#changing-the-default-canonical-membership). Restrictions match the membership type name across all systems. For example, selecting **Gold** applies to a selected Gold membership from either system A or system B.

Each name appears once in the selector, even if that name exists in multiple systems. Select **Review membership types** to inspect the available names and source systems on the [Types](https://docs.perkville.com/features/settings/memberships/types.md) page. That page lists each type/system combination separately; its record counts do not determine an individual customer's eligibility for a join bonus.

If a name is missing, check the membership data supplied by your integration and contact Perkville Support if needed. The join bonus form selects existing names; it does not create new ones.

### Optional unrestricted fallback

You can configure an unrestricted join bonus for customers who do not match a restricted bonus by leaving **Restrict by membership type** off. Without an unrestricted bonus, customers with no matching membership type receive no join bonus.

A customer receives the matching restricted bonus or the unrestricted fallback, not both.


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

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

Perform an HTTP GET request on the following URL with the `ask` and `goal` query parameters:

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

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is what the user is ultimately trying to achieve, the reason they need the answer. Sharing it helps GitBook give you a better, more relevant answer. A goal is most helpful when it describes the outcome the user wants rather than restating the question. For example, with `ask=how do I create an API token`, a goal like `automate deployments from our CI pipeline` lets GitBook tailor the answer to that use case.

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.
