# Show records on a calendar

> Add a Calendar that shows records by a date field in month, week, day or list view, and let people open, drag or add events.

Source: https://tadabase.com/docs/pages/calendar-component  
Status: Verified Nov 17, 2026. Checked against the current product

The **Calendar** component places records on a calendar by one of their date fields, for example jobs by their scheduled date. People can switch between month, week, day and list views, open an event's details, drag it to a new date, or click an empty spot to add a record.

To show the same records in rows per person or asset, such as one row per technician, use the [Resource component](https://tadabase.com/docs/pages/resource-component) instead.

## Add a calendar

1. **Open the page** In the Page Builder, open the page and its **Content** tab. Click the **Components** tab in the left panel.
2. **Add the Calendar** Under **Data Components**, click **Calendar** or drag it into a column.
3. **Choose the records** Answer **Which records should this calendar display?**. Only tables with a **Date**, **Date/Time** or **Date Range** field are listed. See [Choose which table and records a component shows](https://tadabase.com/docs/pages/data-components-overview).
4. **Quick Add or Customize** Click **Quick Add** to add the calendar with a date field picked for you, or **Customize** to set it up first.
5. **Check the date and label** On the **Options** tab, set **Date Field** and **Label Field** (described below).
6. **Save** Click **Update & Close**.

![The Components tab of the Page Builder with Calendar highlighted under Data Components](https://tadabase.com/docs-shots/pages-calendar-add.webp)

The settings window has these tabs: **Data Source**, **Detail View** (when the detail popup is on), **Form View** (when the add form is on), **Event Label Color Rules**, **Filters**, **Options** and **Design**.

## Choose the date and the label

In **General Option** on the **Options** tab:

| Option | What it does |
| --- | --- |
| **Title** and **Description** | A name and a note for the calendar. |
| **Date Field** | The field that places each record on the calendar. A **Date** field shows all-day events. A **Date/Time** field shows the event at its time. A **Date Range** field shows the event from its start to its end, or as all-day when the range is marked all day. |
| **Label Field** | The field shown as the event's text on the calendar, for example the job title or the customer name. File fields cannot be used. |

![The Options tab of a calendar's settings with Date Field, Label Field and the interactive options](https://tadabase.com/docs-shots/pages-calendar-options.webp)

## Let people open, move and add events

| Option | What it does |
| --- | --- |
| **Enable Detail View in Popup** | Clicking an event opens the record's details in a popup. Choose the fields, links and **Enable Inline Editing** on the **Detail View** tab that appears. |
| **Enable Drag/Drop** | People can drag an event to another date or time. The record's date field is updated. Events cannot be stretched to change their length. |
| **Enable Form to Add Additional Records** | Clicking an empty day or time slot opens a form to add a record with that date. Choose the form's fields on the **Form View** tab that appears. Not offered when **Date Field** is the record's created date. |
| **Enable timezone selection** | Adds a time zone dropdown so people can see the events in another time zone. While it is on, drag and drop and the add form are turned off. |

## Set how the calendar opens

| Option | What it does |
| --- | --- |
| **Default Display Mode** | **Calendar** (a grid) or **List** (events listed by date). Calendar is the default. |
| **Default Display Field** | The period shown first: **Month** (the default), **Week** or **Day**. |
| **Default Event Color** | The color of events that no color rule matches. |
| **Starting Day Of Week** | The first day of each week, **Sunday** by default. |

In the live app, buttons above the calendar switch between **Calendar** and **List** and between **Month**, **Week** and **Day**. **Refresh** reloads the events, and clicking a day's number opens that day.

## Color events with rules

On the **Event Label Color Rules** tab, click **Add New Color Rule**, set the conditions a record must match and pick a color. For example, show jobs whose status is Completed in green. Add as many rules as you need.

## Filter the events

- **Data Source** > **Filters**: click **Add New Filter Group** to show only some records on the calendar, for example only upcoming jobs. See [Choose which records a component shows](https://tadabase.com/docs/get-started/filtering-data).
- **Filters**: turn on **Filter Tabs** to show tabs above the calendar, each with its own conditions, that people click to filter the events. **Hide Clear Filter Tab** removes the tab that clears the filter.

The **Design** tab sets the component's fonts, background, border, spacing and CSS.

## Check that it works

Open the page in your live app and go to a period that has records. If an event is missing, check that its date field has a value, the data source filters and the selected filter tab. If dragging does nothing, check that **Enable Drag/Drop** is on and **Enable timezone selection** is off.
