# Add custom client fields

## Overview

Custom fields let you collect additional client information that is not included in Caspen’s standard fields. Once created, custom fields appear on every client profile and can be filled out at any time.

Use custom fields to record details that match your practice, clients, and workflows.

**Custom field types**

You can create these custom field types:

* Short text (single line)
* Long text (multi line)
* Single choice (radio)
* Multiple choice (checkboxes)
* Dropdown (single select list)
* Number
* Date
* Yes or No

Note: You cannot change a custom field type after it is created. If you need a different type, create a new custom field.

***

## Add a custom field

1. Go to **Settings** → **Custom fields**.
2. **Click Add custom field**.

<figure><img src="/files/HA7rlYocmAZLalh7tDIQ" alt=""><figcaption></figcaption></figure>

3. **Enter the field details:**

* **Type:** Choose the field type.
* **Name:** Give the field a clear label.
* **Visible** (toggle):
  * On: The field appears on the client profile.
  * Off: The field is hidden on the client profile and only appears when editing the client.
* **Required** (toggle): Turn this on if the field must be completed before a client record can be created or saved.

<figure><img src="/files/nAQrggVpnIblju2Qt4Gd" alt="" width="480"><figcaption></figcaption></figure>

4. If the field uses options (Single choice, Multiple choice, Dropdown), add the options.
5. Click **Create** (bottom-right) to add the custom field.

<figure><img src="/files/Qeh39PGqa8LPFKflBQ2R" alt="" width="480"><figcaption></figcaption></figure>

**Result**

* Your custom field is available on client records and can be filled out as needed.&#x20;
* If a field is not visible, it will not show on the client profile. You will still see the field when editing the client.

***

## Reorder custom fields

Reorder fields to control the order they appear on the client profile.

1. Go to **Settings** → **Custom fields**.
2. Click **Reorder**.

<figure><img src="/files/UDSQ4e3yBtQMxykEnoio" alt=""><figcaption></figcaption></figure>

3. Drag and drop fields using the **drag handle** (left icon) to change the order.

<figure><img src="/files/CHu0e3NatCXvdLmkoBkx" alt="" width="480"><figcaption></figcaption></figure>

4. Once complete, click **Save order**.

<figure><img src="/files/vdDUToAh7ETnD2PuI65Q" alt="" width="477"><figcaption></figcaption></figure>

***

## Edit a custom field

Use this to update a custom field’s settings (name, visibility, required), and for choice fields, the available options.&#x20;

> Note: You cannot change the field type after the custom field is created. If you need a different type, create a new custom field.

1. Go to **Settings → Custom fields**.
2. Find the field and click **Actions → Edit**.

<figure><img src="/files/Po7bEuHSa0JsUJN5aIJD" alt=""><figcaption></figcaption></figure>

3. Update the field settings, then click **Save**.

What happens to existing client data

* You can rename a field or change its visibility or required setting without losing any client data already saved in that field.
* For fields with options, renaming an option updates that option everywhere it is used.

***

## Archive a custom field

Archive a custom field when you no longer want it used.

1. Go to **Settings** → **Custom fields**.
2. Find the field and click **Actions** → **Archive**.

<figure><img src="/files/6p1qJSl1UqPvEveabIPY" alt=""><figcaption></figcaption></figure>

**What happens when archived**

* The field is removed from active use and can’t be filled out for clients.
* Any values already saved for clients are kept. If you restore the field later, those previous values will appear again.

**Restore an archived field**

1. Go to the **Archived** tab.
2. Find the field and click **Actions → Restore**.

> **Tip:** If you want to start fresh and not reuse previous client values, create a new custom field instead of restoring an archived one.

***

## FAQs

<details>

<summary>What does "visible" setting mean?</summary>

Visible controls whether the field shows on the client profile. If visible is off, the field is hidden on the profile and only appears when editing the client.

</details>

<details>

<summary>Can I change the field type later?</summary>

No. Field type cannot be changed after creation. Create a new custom field if you need a different type.

</details>

<details>

<summary>What happens when I rename an option in a choice field?</summary>

Renaming an option updates the option everywhere it is used, including on clients who already have it selected.

You can choose to archive an option in a choice field and create a new one.

</details>

<details>

<summary>I want to remove a field and also remove any previously entered values</summary>

Archive removes the field from view but retains the data if restored later. If you want a clean start, create a new custom field instead of restoring an archived one.

</details>

<details>

<summary>If I archive an option, does it remove it from clients who already selected it?</summary>

No. An option is a choice inside a field (for example, a dropdown value). Archiving an option prevents it from being selected going forward, but clients who already have it selected will keep it until their value is changed.

</details>


---

# 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/settings/add-custom-client-fields.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.
