---
title: 'Extra Fields'
url: 'https://docs.joomdonation.com/oscalendar/using-back-end/extra-fields'
markdown: 'https://docs.joomdonation.com/oscalendar/using-back-end/extra-fields.md'
date: '2026-10-11'
description: '[TOC] Overview The Extra Fields feature allows you to add custom fields to the front-end booking form. For example, you might want to collect additional guest information such as a flight arrival time, dietary requirements, or special requests. To manage extra fields, go to Components → OS Calendar…'
taxonomy:
  category:
    - docs
---

[](#) [ edit this page](https://github.com/getgrav/grav-skeleton-rtfm-site/blob/develop/pages/02.using-back-end/14.extra-fields/docs.md) 

# Extra Fields

\[TOC\]

## Overview

The **Extra Fields** feature allows you to add custom fields to the front-end booking form. For example, you might want to collect additional guest information such as a flight arrival time, dietary requirements, or special requests.

To manage extra fields, go to **Components → OS Calendar → Manage Extra Fields**.

## Field List

The extra fields list shows all currently configured custom fields with the following columns:

| Column | Description |
|---|---|
| **ID** | Field ID |
| **Field Name** | Internal name (used in the database and email tokens) |
| **Title** | Label displayed to the customer on the booking form |
| **Type** | Input type (text, textarea, select, checkbox, radio, etc.) |
| **Required** | Whether the field is mandatory |
| **Ordering** | Display order on the booking form |
| **Published** | Published / Unpublished status |

## Adding an Extra Field

1. Click **New** in the toolbar.
2. Fill in the field form:

| Field | Description |
|---|---|
| **Field Name** | Unique identifier (no spaces, no special characters). Used as the token name in email templates (`{field_name}`). |
| **Title** | The label shown on the booking form. |
| **Type** | Input type. Available types: `Text`, `Textarea`, `Select (dropdown)`, `Checkbox`, `Radio`, `Date`. |
| **Options** | For `Select`, `Checkbox`, and `Radio` types — enter the options, one per line. |
| **Default Value** | Pre-filled value when the form is displayed. |
| **Required** | Set to Yes to make the field mandatory. |
| **Published** | Publish to show the field on the booking form. |

3. Click **Save** or **Apply**.

## Using Extra Field Values in Emails

Extra field values are automatically included in the booking notification emails. To include a specific field in an email template, use its field name as a token:

```
{field_name}
```

For example, if you created a field with **Field Name** = `arrival_time`, use `{arrival_time}` in your email template body.

## Ordering Fields

Extra fields appear on the booking form in the order defined by the **Ordering** column. Drag the handle on the left of each row to reorder, then click **Save Order**.

 [ ](https://docs.joomdonation.com/oscalendar/using-back-end/email-templates) [](https://docs.joomdonation.com/oscalendar/using-back-end/reports)

---

## Navigation

- Parent: [Using Back-end](https://docs.joomdonation.com/oscalendar/using-back-end.md)
- Previous: [Email Templates](https://docs.joomdonation.com/oscalendar/using-back-end/email-templates.md)
- Next: [Reports](https://docs.joomdonation.com/oscalendar/using-back-end/reports.md)
