> For the complete documentation index, see [llms.txt](https://docs.rafflex.io/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.rafflex.io/club-memberships/club-memberships/managing-members.md).

# Managing Members

See every Club member, check their payments and benefits, cancel memberships, give free memberships and issue rewards by hand.

{% hint style="warning" %}
Club is a Rafflex Pro feature in beta and needs card on file enabled on your Cashflows account. If you do not see **Club** in your admin menu, contact the Rafflex team.
{% endhint %}

Click **Club** in the left-hand menu, then **Members** (under **Members**). The list shows every membership, newest first. You can search by member name and filter by **Status** or **Tier**.

***

### The Members List

| Column           | What it shows                                                               |
| ---------------- | --------------------------------------------------------------------------- |
| **Member**       | The customer's name and email.                                              |
| **Tier**         | Their current tier.                                                         |
| **Status**       | See the table below.                                                        |
| **Cancelling**   | A clock icon if the membership is set to end at the end of the paid period. |
| **Renewal**      | The next payment date.                                                      |
| **Failed**       | How many payments have failed in a row.                                     |
| **Last payment** | The date of the last successful payment.                                    |
| **Comp until**   | When a free membership ends. Hidden by default.                             |

The boxes above the list show your **Active members**, **Monthly recurring revenue**, **New this month** and **Churned this month**. See [Club Insights](https://docs.rafflex.io/club-memberships/club-memberships/club-insights.md).

#### Membership statuses

| Status                                  | Meaning                                                                                                                                                                                    | Charged?                 | Benefits?                       |
| --------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ | ------------------------ | ------------------------------- |
| **Pending**                             | The customer started joining but has not finished paying. Cleared automatically after a short while if they do not pay.                                                                    | No                       | No                              |
| **Active**                              | A paid up member, or a free membership you have given.                                                                                                                                     | Yes, on the renewal date | Yes                             |
| **Active** with the **Cancelling** icon | The member has cancelled and is using up their paid period.                                                                                                                                | No                       | Yes, until the paid period ends |
| **Payment failed**                      | A renewal payment failed and Rafflex is retrying it. See [Payments and Renewals](https://docs.rafflex.io/club-memberships/club-memberships/payments-and-renewals.md#when-a-payment-fails). | Retried automatically    | No, paused                      |
| **Suspended**                           | The customer is on a Timeout or has disabled their account through [Safe Play](https://docs.rafflex.io/additional-settings/settings/safe-play-setting.md).                                 | No                       | No                              |
| **Cancelled**                           | The membership has ended.                                                                                                                                                                  | No                       | No                              |
| **Expired**                             | A join that was never paid for.                                                                                                                                                            | No                       | No                              |

***

### Cancel a Membership

**Cancel at the end of the paid period** (the standard cancellation, for example when a member asks you to cancel):

1. Find the member and click **Cancel (period end)** on their row.
2. Optionally choose why they are cancelling. This feeds your [Club Insights](https://docs.rafflex.io/club-memberships/club-memberships/club-insights.md).
3. Click **Schedule cancellation**.

The member keeps their benefits until their paid period ends, is not charged again, and gets a confirmation email.

**Cancel immediately** (abuse, fraud, compliance, chargebacks, or to close a suspended membership):

1. Click **Cancel now** on the member's row.
2. Choose a **Reason** and optionally add a **Note**.
3. Click **End membership now**.

The membership ends straight away. Daily entries and new benefits stop at once, and the member gets an email to say their membership has ended.

{% hint style="info" %}
Neither option gives a refund or takes back credit and entries the member has already received. To refund a payment, see [Refunds and Chargebacks](https://docs.rafflex.io/club-memberships/club-memberships/payments-and-renewals.md#refunds-and-chargebacks).
{% endhint %}

***

### Other Actions

| Action                     | When to use it                                                                                                                                      |
| -------------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------- |
| **Clear scheduled change** | The member has scheduled a move to a cheaper tier and you need to undo it. They stay on their current tier and price.                               |
| **Retry allocations**      | A benefit shows as **Failed** on the member's record. It tries again to give it. Safe to press more than once, because nothing is ever given twice. |
| **Add note**               | To record something about the membership. Only admins can see notes.                                                                                |

**Things you cannot do from the admin panel**

* **Change a member's tier.** Members change tier themselves from their Club area.
* **Update a member's card.** The member rejoins with a new card from their Club area instead.
* **Reactivate a suspended or cancelled membership.** A suspended membership never ends by itself, so if the customer wants to join again, close it with **Cancel now** first.
* **Export the members list.**

***

### Give a Free Membership

Use **Comp a membership** at the top of the Members list to give a customer a free membership, for example as a prize or a thank you.

1. Click **Comp a membership**.
2. Choose the **Customer** and **Tier**.
3. Choose a **Term**: **Indefinite**, or 1 to 12 months.
4. Click **Comp membership**.

The customer gets the welcome email and their benefits straight away, then again every month for free. A few days before a fixed term ends they get an email, and when it ends the membership ends by itself. Free memberships are not included in your monthly recurring revenue.

You cannot comp a membership while the Club is switched off, on an inactive tier, or for a customer who already has a membership or is on a Timeout or has disabled their account.

***

### A Member's Record

Click a member to open their record. It shows their tier, status, billing dates, failed payments and, if their tier has milestone rewards, their **Reward progress** (for example "4 of 6 paid months towards Tartan gift").

| Tab                | What it shows                                                                                                                                                                                                                     |
| ------------------ | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| **Benefit ledger** | Every benefit given. **Issued** means given in full, **Capped** partly given (for example the competition's per person limit was reached), **Skipped** not given, **Failed** will be retried, and **Pending** is being given now. |
| **Payments**       | Every Club payment and whether it succeeded, failed or was refunded.                                                                                                                                                              |
| **Rewards**        | Milestone rewards earned. Click **Open** to send one.                                                                                                                                                                             |
| **History**        | Everything that has happened to the membership, including your notes.                                                                                                                                                             |

#### Issue a reward by hand

You can give a member a milestone reward now, whatever their number of paid months. For example, after you lower a reward's months, or to make up for a problem.

1. Open the member's record.
2. Click **Issue a reward** at the top.
3. Choose the **Reward** and confirm.

Each reward can only be issued once per member, and only to an active membership.

***

### Event Feed

Click **Club**, then **Event feed** (under **Insights**) to see the history of every membership in one place. Filter by event type, status or date, and click **View member** to open a record. In the status filters, **Past due** means **Payment failed**.

Common events:

| Event                                   | Meaning                                                                          |
| --------------------------------------- | -------------------------------------------------------------------------------- |
| `payment_succeeded`                     | A new membership started (a join, a rejoin or a free membership).                |
| `payment_renewed`                       | A renewal payment was taken.                                                     |
| `payment_failed`                        | A renewal payment failed.                                                        |
| `payment_recovered`                     | A retry of a failed payment succeeded.                                           |
| `dunning_exhausted`                     | All automatic retries of a failed payment were used up, so the membership ended. |
| `customer_requested`                    | The member cancelled.                                                            |
| `admin_requested`                       | An admin cancelled at period end.                                                |
| `admin_cancelled_immediately`           | An admin used **Cancel now**.                                                    |
| `cancellation_period_ended`             | A cancelled membership reached the end of its paid period.                       |
| `tier_change_scheduled`, `tier_changed` | The member scheduled or completed a tier change.                                 |
| `renewal_cap_held`                      | A renewal was put on hold by the member's spending limit.                        |
| `admin_note`                            | An admin added a note.                                                           |
