> 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/customers/customer-program-status.md).
# Customer program status
This status describes one customer's relationship with a business. It differs from [Business program status](/features/settings/business/business-program-status.md) and [Location program status](/features/settings/location-setup/locations/location-program-status.md).
Perkville uses several different statuses for a customer. These statuses describe different things and should not be used interchangeably.
| Status | What it represents | Where it comes from | What it affects |
| --------------------- | ------------------------------------------------------------ | ------------------------------------ | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| **Perkville status** | The customer's overall Perkville account | The customer's Perkville account | Whether the Perkville account itself is active. A user who closes their account can show **Inactive (Closed by user)**. See [Reversing a user's Perkville account closure](/features/customers/reversing-a-users-perkville-account-closure.md). |
| **Program status** | The customer's connection to your business's loyalty program | Perkville | Whether the customer has been added, invited, joined, or disconnected from your program. The statuses are Imported, Pending, Active, and Inactive. |
| **Membership status** | The customer's membership relationship with your business | Your connected membership/POS system | Eligibility and membership-powered behavior such as participation restrictions, membership earning activities, and cancellation-based point expiration. See [Memberships](/features/customers/memberships.md). |
A customer can therefore have an active external membership while their Perkville **program status** is Pending or Inactive, or have an Active program status while their external membership is inactive. When troubleshooting, first identify which status is causing the issue.
## Imported, Pending, and Active Statuses
| Status | Added to program? | Invited? | Joined? |
|---|
| Imported | true | false | false |
| Pending | true | true | false |
| Active | true | true | true |
## Inactive Status
**Definition:** The customer has been disconnected from the business on Perkville. This may happen if the customer opts out of the reward program or if the business manually disconnects the customer.
**Implications:** An inactive status means the customer will no longer receive any communications from the business through Perkville. The business may need to investigate the reasons for the disconnection and consider re-engagement strategies if appropriate. Businesses can change this status to "Pending".
## Steps to change program status
Business staff members can update a customer’s loyalty program status from the customer profile page. This functionality allows you to manage a customer's engagement with your loyalty program directly from their profile.
1. **Navigate to the Customer’s Profile**:
* From your Perkville Dashboard, search for the customer by their name or email address.
* Click on the customer’s name to open their profile.
2. **Locate the Loyalty Program Status section**:
* On the right-hand side of the customer profile page, you will see the **Loyalty Program Status** section.
* This section displays the current status of the customer within the loyalty program (e.g., **Active**, **Pending**, or **Inactive**).
3. **Edit the status**:
* Click on the **pencil icon** next to the Loyalty Program Status.
* The available status changes depend on the customer's current connection state. Supported options can include **Active**, **Inactive**, and **Pending**.
* Changing a customer to **Inactive** disconnects them from your business on Perkville, stops communications, and prevents participation.
* Changing an eligible **Inactive** customer to **Pending** re-establishes the connection so the customer can be invited to rejoin.
* Changing a customer to **Active** means the customer has joined the program. A registration bonus may be awarded if one applies.
* Once the status is updated, it will be reflected immediately in the system.
4. **Save the Changes**:
* After selecting the new status, ensure you save the changes to update the customer’s profile.
---
# 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/customers/customer-program-status.md?ask=&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.