> 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/settings/memberships/types.md).

# Membership types

Control loyalty activity by membership type and view membership record counts

Open **Settings → Memberships → Types** to view the membership types supplied to Perkville. This page is available when [membership features](https://docs.perkville.com/features/settings/memberships/settings.md) are enabled for your business.

Each row represents a membership type and its source system ID. The same name can appear more than once when it is used in different systems.

**No system id** means the catalog entry has no associated system ID. This can include names saved in earlier join bonus configurations. A row with no system ID is not a restriction that applies only to members without a system ID.

The page is for viewing, searching, and controlling loyalty-program activity by membership type. It does not provide controls to manually add, rename, or delete membership types.

## Control loyalty-program activity by membership type

Use the loyalty activity control on each membership type to decide which members can participate in your loyalty program. Enable activity for the types that should have access. Disable it for types that should not.

1. Open **Settings → Memberships → Types**.
2. Find the membership type and source system you want to update.
3. Use the type's loyalty activity control to enable or disable activity.
4. Repeat for each type that needs a different setting.

This is a program-wide control for customers with that membership type. It is separate from individual earning rules and rewards. A membership type can remain in the list and continue receiving membership data even when loyalty activity is disabled.

{% hint style="warning" %}
Confirm that your integration supplies accurate membership types before changing loyalty activity. A missing or incorrectly mapped type can affect a customer's program access.
{% endhint %}

## Understand the counts

The total on each row counts external membership records for that type and system. It includes:

* **Active:** Records with an active membership status.
* **Inactive:** Records with an inactive membership status.
* **Unknown:** Records without a recognized active or inactive status.

The total is the sum of those three groups. These figures do not count unique customers. For example, one customer with two membership records can contribute two records to the totals.

Types remain listed when their counts reach zero. A legacy entry with no system ID may have zero records while a separate entry with the same name and a known system ID has records.

Counts refresh in the background approximately every ten minutes. A refresh takes time, so changes may not appear immediately. **Oldest counts as of** shows the oldest count-query timestamp represented in the catalog, in the displayed timezone. It is not a record's last-modified time.

**Not calculated yet** means that entry has not received its first completed count refresh. It does not mean zero.

These counts help you understand membership data. They do not decide an individual customer's eligibility for join bonuses or other perk-level restrictions.

## Find a type or system

Use the **Membership type** filter, the **System ID** filter, or both, then select **Search**.

* Choose a membership type to see its entries across systems.
* Choose a system ID to see types from that system.
* Choose both to see that combination.
* Use the **x** inside a filter to clear it, then select **Search** again.

Both filters show all available choices. After selecting a membership type and a system, click **Search** to show entries matching both. If that combination doesn't exist, no results appear.

For larger catalogs, begin typing a membership name to fetch matching options. Enter more of the name if the result list asks you to narrow the search. Smaller catalogs let you browse and search the available names immediately.

Results are alphabetically ordered and paginated. The copy button beside a name copies the membership type name. The information bubble shows the catalog's total number of type/system entries and explains that customers can have multiple membership records.

## Use types in perk-level restrictions

Join bonus restrictions use membership names across all systems. Selecting **Gold** in a join bonus applies to a customer's [selected Gold membership](https://docs.perkville.com/features/customers/memberships.md#changing-the-default-canonical-membership) regardless of its system ID. The join bonus selector therefore lists Gold once, even when this page lists Gold for several systems.

The loyalty activity control above applies at the type-and-source-system level. Use it when you want to control overall program activity for a membership type. See [Join](https://docs.perkville.com/features/earning-rules/join.md) for restricted bonuses and fallback behavior.

## Troubleshoot missing or unexpected data

* **The Types page is missing:** Check whether [membership features](https://docs.perkville.com/features/settings/memberships/settings.md) are enabled. Confirm the integration is supplying membership data before enabling participation restrictions.
* **A type is missing:** Clear filters, check the source membership data, and allow processing time. Contact [Perkville Support](https://docs.perkville.com/overview/support.md) if it remains missing.
* **A count seems different from a customer total:** Compare external membership records, including their statuses and systems, rather than unique customers.
* **Counts appear stale:** Check the displayed timestamp. If it remains stale across expected refreshes, contact Perkville Support.
* **A type has zero records:** The catalog retains previously recorded names. Zero is different from **Not calculated yet**.


---

# 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/settings/memberships/types.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.
