Adding a New Membership for a Client
The membership is the client’s subscription to a package for a specific period, such as a monthly or yearly gym subscription. The package sets the subscription price, its duration, and the credits the client gets, such as the number of sessions or visits. Each client has one membership, on which subscriptions are renewed, and the system tracks its status (active, expired, suspended…) and its expiry date automatically.
This guide explains how to add a new membership, and everything that happens in the system after adding it: the invoice, the subscription, the credits, the expiry date, the status, and the reports.
Contents
- Before You Start
- Steps to Add a Membership
- Fields Explained
- The Effect on the System After Saving
- After Paying the Invoice: The Subscription and Credits
- Membership Statuses
- Settings That Affect Adding a Membership
- Actions on the Membership After Adding It
- Reports
- Error Messages and Their Solutions
- Frequently Asked Questions
Before You Start
- Enable the app Memberships from Apps Manager, and it requires enabling the Credits app.
- Add at least one package of the membership type in Packages, and make sure it is active; inactive packages don’t appear in the form.
- Make sure the client doesn’t already have a membership; each client has one membership. To change the package of a client who has a membership, use Renew from their membership page.
Steps to Add a Membership
- Open Manage Memberships and click New Membership.
- In Membership Information Choose Client, or click New Client to add a new client.
- Choose Package, or choose Add Package from the list to add a new package.
- Set Join Date and Invoice Date.
- Write Description if you want, then click Save.
- The message Membership Added Successfully, and the system creates the subscription invoice and takes you to Add Payment to record the payment.
🛈
Note: If the invoices setting in Memberships Settings is set to Draft, the invoice is created as a draft and you are taken to its edit page to review and issue it before payment.
Fields Explained
| Field | Description | Required | Appears |
|---|---|---|---|
| Client | The client who owns the membership. It can’t be changed after saving. | Yes | Always |
| Package | Active packages of the membership type only. It sets the invoice price, the subscription duration, and the credits. It can’t be changed after saving except by renewal. | Yes | Always |
| Join Date | The membership start date; the default is today’s date. If it is in the future, the status is Upcoming until it arrives. | Yes | Always |
| Invoice Date | The subscription invoice date; the default is the join date. | Yes | On adding only |
| Expiry Date | It isn’t entered when adding; the system calculates it from the package duration after the invoice is paid, and it can be edited manually from Edit. | On editing | On editing only |
| Description | Internal notes about the membership. | No | Always |
The Effect on the System After Saving
| Place | What Happens |
|---|---|
| The membership | It is added in Manage Memberships with an ID, and its expiry date is temporarily the join date until the invoice is paid. |
| Subscription invoice | It is created automatically in Invoices for the client, with one item, the package, with a quantity of 1, at the package price or at the client’s price list price if any, with the package taxes. It is issued unpaid, or Draft depending on the settings. |
| Journal entries | They are recorded from the invoice like any sales invoice (client debit, sales and tax credit). A draft doesn’t create an entry. |
| Client balance | The client’s amount due increases by the invoice value until it is paid. |
| Client page | The tab The membership appears with the membership and its details. |
| Activity log | Adding the membership is recorded. |
| Status | It is calculated automatically, and the system tracks its change on time (such as changing to expired). |
After Paying the Invoice: The Subscription and Credits
The subscription and credits aren’t created on saving, but when the invoice is paid fully or partially:
- A subscription in Manage Subscriptions is created with a start and end date according to the package duration (end date = start + package duration − one day), with the price and the invoice number. Packages without a set duration don’t expire.
- The client is given credit in Credit Charges for each credit type in the package, valid from the subscription start until its end.
- The Expiry Date and Current Package in the membership is updated, and the status is recalculated.
- The invoice shows the tab Membership Subscriptions.
If the invoice becomes unpaid again (such as deleting the payment), the subscription credit is suspended. If the invoice is deleted, its credits are suspended.
Example
Membership Statuses
| Status | When |
|---|---|
| Upcoming | The join date is in the future. |
| Active | After the membership starts and before it expires, or during the grace period days after expiry. |
| Expired | After the expiry date and the grace period days without renewal. |
| Suspended | You suspended it manually with Suspend, and it doesn’t change automatically until Undo Suspension. |
| Frozen | During a freeze period you added with Add Freeze Period. |
🛈
Note: A membership before the first invoice is paid has its expiry date equal to the join date, so it becomes expired after the grace period days if the invoice isn’t paid.
Settings That Affect Adding a Membership
From Memberships Settings (Memberships Policy):
| Setting | Effect |
|---|---|
| Invoices Generated For Membership Subscriptions | Draft: the invoice is created as a draft and opened for editing, and it doesn’t affect the accounts until it is issued. issued: it is issued directly and you move to record the payment. |
| Renewal Grace Period Days | The number of days the membership stays Active after its expiry date before it becomes Expired. |
| Clients Allowed to Log Attendance | When client attendance is enabled: All Clients, or All Members, or Active Members only. |
Actions on the Membership After Adding It
| Action | What Happens |
|---|---|
| Renew | Choose the package and the invoice date, so a new invoice is created, and the subscription and credits are created after it is paid. You can renew with a different package. |
| Edit | Only the join date, expiry date, and description can be edited. |
| Suspend / Undo Suspension | Suspending the membership manually and restoring it. |
| Add Freeze Period | Freezing the membership for a specific period. |
| Delete | Available only if the membership has no subscriptions (that is, its invoice wasn’t paid). |
| Deleting a subscription | From Manage Subscriptions; the membership expiry date returns to the end of the previous subscription, and the deleted subscription’s credits are suspended. |
| Editing the subscription invoice | Not available after the subscription or credit is created from it. |
Reports
| Report | Shows |
|---|---|
| New Memberships | New memberships in a period. |
| Memberships Subscriptions | Subscriptions and renewals. |
| Expired Memberships | Memberships that expired. |
| Credit Charges and Credit Usages | Granted and consumed credits. |
Error Messages and Their Solutions
| Message Shown | Cause | Solution |
|---|---|---|
| The selected client already has a membership | Each client has one membership. | Open the client’s membership and use Renew. |
| This is a required field and could not be empty. | The client, package, or join date is empty. | Complete the field. |
| The expiry date should be greater than or equal the join date | When editing, the expiry date is before the join date. | Correct the date. |
| Could not save the invoice, Please fix errors below | The subscription invoice couldn’t be created, such as a problem in the package tax or numbering. | Review the package and invoice settings and try again. |
| You cannot delete the Membership as there’s a related Subscription(s) | The membership has subscriptions. | Delete the subscriptions first, or suspend the membership instead of deleting it. |
| The package doesn’t appear in the list | The package is inactive or isn’t of the membership type. | Activate the package from Packages. |
Frequently Asked Questions
What is the difference between the membership, the subscription, and the package?
The package is the offer (price, duration, and credits), the membership is the client’s file, and the subscription is each paid period on the membership. So the client has one membership and several subscriptions.
Why is the membership expiry date equal to the join date after adding it?
Because the expiry date is calculated after the invoice is paid, from the package duration.
Is the invoice created automatically?
Yes, on saving, issued or as a draft depending on the settings.
When does the client get the package credits?
After the invoice is paid fully or partially.
Can the membership package be changed?
Not by editing; renew the membership and choose the new package.
Can a membership be added for a client who has a membership?
No, renew their current membership.
Does the client receive an email or message when the membership is added?
No, no email or SMS is sent automatically when the membership is added. You can send the invoice to the client from its page.
Can a membership be deleted after its invoice is paid?
No, because it has a subscription. Suspend the membership instead of deleting it.