# Assign a package to a client

## 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="/files/BJKUR87dhIoPoUSFnIRj" alt=""><figcaption></figcaption></figure>

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

<figure><img src="/files/QH6Hyt2HhhMK7D5vXOQM" 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="/files/iRDUNjeepnR6sUnTB37i" 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="/files/PzCJFfGtCs4bnRI5XkNR" 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="/files/5R0jb3FHMSVcRgRAlt2Y" 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="/files/a1cD41V2c0dYIlExc0RB" 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="/files/oKoAJSX5QbpwTHLntdWb" 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="/files/VeoY1xPtLAYQ545jlR4x" alt=""><figcaption></figcaption></figure>

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

<figure><img src="/files/GsGeCL06UCLMuQYzLavb" 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="/files/fPaHKKBgaWD2ujeq3oKb" 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="/files/VpCLkmbkxBuoIiSKBYET" 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="/files/PPFvcnq0gejhnEeQ0qbl" 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**.

***

## FAQs

<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>


---

# Agent Instructions: 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:

```
GET https://support.caspen.com/using-caspen/catalog/packages/assign-a-package-to-a-client.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
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.
