> For the complete documentation index, see [llms.txt](https://support.caspen.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://support.caspen.com/using-caspen/catalog/packages/assign-a-package-to-a-client.md).

# Assign a package to a client

Learn how to add an existing package to a client so credits can be used when you book an appointment.

## How to assign a package to a client

{% hint style="warning" %}
**First time with packages?**\
If you don't have any packages set up yet, **create a package in your catalog** first, then **assign it to a client**.

**Create a package** →  [**Add a package**](/using-caspen/catalog/packages/add-a-package.md)**.**
{% endhint %}

1. Go to **Clients**, search and open the client (click their name or **Actions** → **View**).

<figure><img src="https://3848983471-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F8mHp6Xvui6hSl3fbco11%2Fuploads%2FlkG3CgFXwubNbgodqAQV%2Fview_client.png?alt=media&amp;token=987d9d84-fafe-4b4e-bb6f-dec640a3700c" alt=""><figcaption></figcaption></figure>

2. In the **Overview** tab, find the **Packages** section, then click **Create package**.

<figure><img src="https://3848983471-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F8mHp6Xvui6hSl3fbco11%2Fuploads%2FcrInLOfCnJEpowvHHJeE%2Fclient_package_1.png?alt=media&amp;token=f678477f-e695-48f1-a78e-dd3ad8da5438" alt=""><figcaption></figcaption></figure>

3. Select a package from the list (you’ll see price, credits, services, and expiry), then click **Create** to assign it to the client.

<figure><img src="https://3848983471-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F8mHp6Xvui6hSl3fbco11%2Fuploads%2FofOYgtKaItwLSzJTpq1x%2Fselect_pack.png?alt=media&amp;token=bfc5e8ca-c4d4-4990-8db7-3403b82023f3" alt="" width="554"><figcaption></figcaption></figure>

4. (*Optional*) A **Create invoice for package** window opens. Choose **Practitioner** and **Location**, then click **Create** to generate the invoice or click **Cancel** to skip and invoice later.

<figure><img src="https://3848983471-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F8mHp6Xvui6hSl3fbco11%2Fuploads%2FX1xT4REs2vqdR1MYr5mq%2Fcreate_invoice_for_package.png?alt=media&amp;token=60753e5d-ba59-4911-bf99-cdb63bf7e278" alt="" width="319"><figcaption></figcaption></figure>

**After assignment you will see:**

* **Status:** Active, Completed, Expired, Canceled.
* **Usage:** Credits, Consumed, Remaining, Expires.
* **Available services** for this package.
* **Any linked appointments** and **invoices**.

<figure><img src="https://3848983471-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F8mHp6Xvui6hSl3fbco11%2Fuploads%2FJncb8z6cMKzLWfBqvGxG%2Fexample_package_img.png?alt=media&amp;token=3eb9e7a5-1210-4832-9c10-e4c0a1bee34a" alt=""><figcaption></figcaption></figure>

#### Find the package later

You can view a client package from their profile, go to **Overview → Packages**. Click **View** on the row to open the package.

<figure><img src="https://3848983471-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F8mHp6Xvui6hSl3fbco11%2Fuploads%2Fgur5Aj5qAn5gZaQkgmOd%2Fclient-profile_package.png?alt=media&amp;token=dcc3ae6b-bb5c-4929-9cf6-b5b3269d1590" alt=""><figcaption></figcaption></figure>

***

## Use a package when booking

1. Open **Calendar** → **Create appointment** and choose the **Client**.
2. If the client has eligible packages, a green banner shows “**X package matches — View**”.&#x20;

* *X = the number of the client’s **eligible** packages (Active, not Expired or Canceled).*

3. Click **View**.&#x20;

<figure><img src="https://3848983471-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F8mHp6Xvui6hSl3fbco11%2Fuploads%2FyHbtOM3usTd1zoWaEkNB%2Fcreate_appointment_package.png?alt=media&amp;token=7dfc69de-d3e6-4f9a-918c-f40808356909" alt="" width="424"><figcaption></figcaption></figure>

4. In the **Link package** popup screen, select the **package**, then choose the **Service** it covers.

* *For fixed packages, you will see the remaining allowance for that service (e.g., 0 of 3 used). For flexible packages, there is no per service allowance shown. Remaining credits are shown at the package level.*

<figure><img src="https://3848983471-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F8mHp6Xvui6hSl3fbco11%2Fuploads%2FDIOjtOZSKpj6BiVMD3gG%2Flink_package.png?alt=media&amp;token=e3d8ff0b-5542-4d7c-b3be-dc05e12b67c2" alt=""><figcaption></figcaption></figure>

5. Complete the appointment details and click **Create appointment**.

<figure><img src="https://3848983471-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F8mHp6Xvui6hSl3fbco11%2Fuploads%2FpJyzEQ9FSp0A4TFahfNF%2Flinked%20to%20appointment.png?alt=media&amp;token=ace144cd-32da-479d-8e26-11e40e774bcb" alt="" width="432"><figcaption></figcaption></figure>

**Result:**

* One credit is consumed from the selected package (per the package rules).&#x20;
* The appointment information panel shows **Linked to package:** **\[Package name]** to confirm the booking uses that package (shown below).

<figure><img src="https://3848983471-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F8mHp6Xvui6hSl3fbco11%2Fuploads%2F0KhzfqGlEp4jvDt5n7l0%2FInitial%20consultation_linked_package.png?alt=media&amp;token=f8381a9e-9fc1-40ea-988a-27e14c7330db" alt="" width="411"><figcaption><p>Appointment panel showing Linked package: Physio Starter Pack (5 sessions).</p></figcaption></figure>

***

## Invoice a package

You can:

* Invoice the package **when you assign it**, or
* Invoice later from the client profile: open the package and click **Create invoice**.

<figure><img src="https://3848983471-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F8mHp6Xvui6hSl3fbco11%2Fuploads%2FaLFarqXzX9EdM4YzJifT%2Fcreate_package_invoice.png?alt=media&amp;token=74e916b7-d8b0-427a-b934-8a739156fe58" alt=""><figcaption></figcaption></figure>

***

## Unlink an appointment from a package

{% hint style="info" %}
After unlinking, the appointment will not use a package credit. To link a different package, unlink the current one first. If a matching client package exists, a **Package matches** banner appears at the top of the appointment panel so you can select it.
{% endhint %}

1. Open **Calendar** and click the appointment.
2. In the appointment information panel, click **Edit details**.
3. At the top, find **Linked to package \[package name]** and click the **X** to remove the link.

<figure><img src="https://3848983471-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F8mHp6Xvui6hSl3fbco11%2Fuploads%2FCpDup8tNtlXyfaag02vY%2Funlink_package.png?alt=media&amp;token=952e9657-71ff-4604-acec-1ad1b1880152" alt="" width="423"><figcaption></figcaption></figure>

4. Click **Update appointment**.

***

**Tips:**

* **Fixed vs flexible:** Fixed packages show per-service allowances (e.g., 0 of 3 used). Flexible packages draw from a shared credits pool.
* **Not seeing a package?** It may be **Completed**, **Expired**, or **Canceled**.

***

## Frequently asked questions

<details>

<summary><strong>Can I take a deposit for a package?</strong></summary>

Yes. Create the client package and finalise its invoice. On the invoice, select Pay invoice, choose a payment method, and enter a deposit. Caspen records a part payment and leaves the remaining balance open.

&#x20;Need a hand? Reach out to us and we’ll walk you through it.

</details>

<details>

<summary><strong>What happens when a package expires?</strong></summary>

The package is marked Expired. Any remaining credits can’t be used and won’t show as a match when booking.&#x20;

</details>

<details>

<summary><strong>How do I see remaining credits for a client?</strong></summary>

Go to Clients → open the client → Overview → Packages. Find the package and click View to see Remaining credits and Expiry.

</details>

<details>

<summary><strong>What if I want to bill for something else after I have created the invoice?</strong></summary>

* If the invoice is in draft, open it and add the extra items, then save or finalize.
* If the invoice is finalized, create a new invoice for the additional charges.

</details>

<details>

<summary><strong>Can I use repeating appointments with packages?</strong></summary>

No. Packages can’t be applied to repeating appointments. Book each appointment separately to use package credits.

</details>

<details>

<summary><strong>Can clients book packages online?</strong></summary>

Not at this stage. Most practices discuss packages with clients before purchase. If online package sales would help your practice, please let our team know.

</details>

\ <br>
