> For the complete documentation index, see [llms.txt](https://docs.yaycommerce.com/bookster/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.yaycommerce.com/bookster/addons/custom-fields.md).

# Custom Fields

Ask customers for more information when they book, such as a pet's name, a file, or agreement to your terms. You add your own fields to the contact step of the booking form.

{% hint style="info" %}
Needs the **Custom Fields** addon, included in [All Access](https://wpbookster.com/downloads/all-access/).
{% endhint %}

Open the screen from **Settings › Custom Fields**. It has two lists and a preview:

* **Customer Fields**: saved on the customer, and filled in for them the next time they book.
* **Appointment Fields**: saved on each appointment.
* **Preview Booking Fields**: shows the contact step as customers will see it.

Click **Save Changes** when you're done.

<figure><img src="https://3654694329-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FOokiT38oKvyMtYds88Kp%2Fuploads%2Fgit-blob-c2f0fd04be47a8e1be8d0e9826b4a52af065d783%2Fcustom-fields-settings.webp?alt=media" alt="Custom Fields settings with customer and appointment fields and the booking fields preview"><figcaption><p>Settings › Custom Fields.</p></figcaption></figure>

### Add a field

1. Click **New Custom Field** in **Customer Fields** or **Appointment Fields**.
2. Fill in the field's settings (below).
3. Click **Save Changes**.

<figure><img src="https://3654694329-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FOokiT38oKvyMtYds88Kp%2Fuploads%2Fgit-blob-980b4516163b3dabb5c42c746f1a2c1771998f79%2Fcustom-field-card.webp?alt=media" alt="An open True/False field with Label HTML, Default value and Help text"><figcaption><p>A field's settings.</p></figcaption></figure>

### Field settings

* **Input type**: **Text**, **Text area**, **Email**, **Number**, **True/False**, **Checkbox**, **Radio** or **Select**. Appointment fields can also be an **Attachment**.
* **Column Width**: **50%** (half the form's width) or **100%**.
* **Field label**: the name customers see, up to 50 characters.
* **Choices** (Checkbox, Radio and Select): type an option and press Enter to add it.
* **Set as required**: the customer must fill in the field before they can continue.
* **Label HTML** (True/False only): a label with links, for a terms box such as `I agree to the <a href="/terms">Terms & Conditions</a>`.
* **Default value**: what the field holds before the customer types. For True/False, tick **Checked by default**; for Select, pick an option or **No default**. Not offered for Attachment, Checkbox and Radio. A returning customer sees their saved answer instead.
* **Visibility rules**: show the field only in some cases. See below.
* **Help text**: a hint shown below the field.

For an **Attachment**, also set:

* **Max files**: 1 to 20. The default is 1.
* **Max size**: per file, in MB. The default is 2 MB.
* **Accepted types**: such as **Images**, **PDF** or **Word (.docx)**. The default is images and PDF.

Bookster saves only files within these limits.

### Show a field only when it applies

A new field shows on every booking (**Always**). To show it only in some cases:

1. Open the field and click **Visibility rules**.
2. Click **Add condition**.
3. Pick what to check: **Service**, **Service Category**, **Agent**, **Location** (when the Location addon is active), or another field in the same list.
4. Pick **is**, **is not**, **is empty** or **is not empty**, and the value.
5. With more than one rule, set **Match** to **ALL** (every rule must match) or **ANY** (one is enough).
6. Click **Save Changes**.

<figure><img src="https://3654694329-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FOokiT38oKvyMtYds88Kp%2Fuploads%2Fgit-blob-67616bf0f6fc1d0dc2d98015e5cbb91276882e95%2Fcustom-field-visibility-rules.webp?alt=media" alt="Visibility rules with two conditions, Service Category is Spa Treatments and Location is Main Location, matching ALL"><figcaption><p>A field shown only for one service category at one location.</p></figcaption></figure>

{% hint style="warning" %}
Known issue: a field with visibility rules isn't enforced as required yet, even with **Set as required** ticked.
{% endhint %}

### Manage your fields

* **Turn a field off**: use the switch on the field's row. The field leaves the booking form; saved answers stay.
* **Reorder**: drag a field by its handle on the left.
* **Delete**: hover the field's row, click the minus icon, then **Delete**.

Renaming a saved field keeps its saved answers.

## What staff see

Staff see and edit customer fields on the customer, and appointment fields on the appointment.
