Back

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.

Required PermissionsManage Memberships. To add a package from the same screen: Manage Packages, and to add a new client: the permission to add clients. These are set from Employee Roles.
How to AccessDirect link: New Membership. Or from the main menu: Memberships → Manage Memberships → New Membership. Or from the client’s page → the tab The membership → New Membership.

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

  1. Open Manage Memberships and click New Membership.
  2. In Membership Information Choose Client, or click New Client to add a new client.
  3. Choose Package, or choose Add Package from the list to add a new package.
  4. Set Join Date and Invoice Date.
  5. Write Description if you want, then click Save.
  6. 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

A client subscribed to a monthly package for 300 riyals that includes 12 sessions, with a join date of 1/10. After saving, an unpaid invoice of 300 is created, and the membership expiry date is 1/10. After payment, a subscription is created from 1/10 to 31/10, and a credit of 12 sessions valid until 31/10, and the membership expiry date becomes 31/10.

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.