> For the complete documentation index, see [llms.txt](https://help.peoplevine.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://help.peoplevine.com/products/control-panel-overview/membership-setup-overview/configure-guest-pass-allocation.md).

# How to Configure Guest Pass Allocation

### Before you begin (Prerequisites)

* **Permissions**: Administrator or Supervisor. See: [How to Manage Users and Permissions](/products/control-panel-overview/admin-overview/manage-roles-permissions.md).
* **Membership Program**: The program must already exist. See: [How to Create a Membership Program](/products/control-panel-overview/membership-setup-overview/create-membership-program.md).
* **Guest Pass Voucher**: A voucher of type Guest Pass must already exist. If it does not, create one under [**MEMBERS > Manage Vouchers**](https://control.peoplevine.com/vouchers) first.

### Instructions

1. Navigate to [**MEMBERS > Manage Membership Programs**](https://control.peoplevine.com/admin_membership_list.aspx).
2. Find the target program and click the **Menu** button (blue icon, rightmost column).
3. On the program detail page, scroll to the **MEMBER PERKS** section and click **MANAGE MEMBER PERKS**.
4. On the **Add Member Perks** form, select the **Voucher** tab under "What perks do they get?"
5. Set the **Frequency** — how often the perk is issued:

   | Option                                          | When it issues             |
   | ----------------------------------------------- | -------------------------- |
   | One-time                                        | Once at enrollment         |
   | Daily / Weekly / Monthly / Quarterly / Annually | Recurring on that schedule |
6. Use the search field to find the guest pass voucher, then toggle it on to select it.
7. Configure the perk settings:

   | Field                           | Description                                                                                                                                                                                                                                                   |
   | ------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
   | **Provide a Brief Description** | Optional internal note for this perk.                                                                                                                                                                                                                         |
   | **Valid From / Valid Through**  | Date range the pass is valid. Leave blank to use the voucher's default.                                                                                                                                                                                       |
   | **Total To Issue**              | Number of passes issued per cycle (default: 1).                                                                                                                                                                                                               |
   | **Valid Starting At What Time** | Time of day the pass activates, based on the club's local timezone. Recommended: choose a time after the club closes and before it opens the next day (e.g., 4 AM) to prevent late-night reuse. The daily allotment only refreshes once this time has passed. |
   | **Issue to Sub Members?**       | Toggle on to issue passes to sub-members as well.                                                                                                                                                                                                             |
   | **Valid in Days**               | Days after issuance before the pass activates. Leave blank for immediate availability.                                                                                                                                                                        |
   | **Valid For Days**              | How long the pass is valid after issuance. For example, if using a monthly frequency and passes should not roll over, enter 30 or 31 days. Leave blank to expire in 30 days if no Valid From/Until is set.                                                    |
8. Click **ADD**.

All new members of the program will automatically receive the guest pass perk upon enrollment.

> **Note**: Perks are only issued when the membership status is **Active**. Members in Pending, Failed, Suspended, or other non-Active statuses do not receive perk allocations until their membership becomes Active.

> **Note (Pro Dash):** Navigate to **REWARD > Manage Membership Programs**.

### What Happens Next

* **On the member side**: Guest passes appear in the member's portal wallet. Members can share passes via email or SMS.
* **Re-issuing to existing members**: If you add a perk after members are already enrolled, those members will not receive it automatically. Return to the membership program and select **RE-ISSUE PERKS TO ALL MEMBERS** to push the perk to existing members.
* **Next step**: To issue a guest pass directly to an individual member outside the perk cycle, see: [How to Issue Guest Passes to a Member](/products/control-panel-overview/membership-management-hub/issue-guest-passes.md).

*Last updated: 2026-05-24*


---

# 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 dynamically by asking a question.

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

```
GET https://help.peoplevine.com/products/control-panel-overview/membership-setup-overview/configure-guest-pass-allocation.md?ask=<question>&goal=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

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.
