> ## Documentation Index
> Fetch the complete documentation index at: https://help.teable.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Calendar

> View and manage records by date, such as meetings, events, schedules, and project timelines.

Calendar view displays records on a calendar. If a table has a single-value date field, you can use Calendar view to track tasks, meetings, events, publishing plans, or project milestones.

## Use Cases

| Scenario                  | Good for                                                           |
| ------------------------- | ------------------------------------------------------------------ |
| Meetings and appointments | Meeting times, customer visits, interviews                         |
| Project scheduling        | Start dates, due dates, milestones                                 |
| Content planning          | Publish dates, campaign dates, marketing schedules                 |
| Multi-day items           | Projects, events, leave requests, or work with start and end dates |

## Create a Calendar View

<Steps>
  <Step title="Create a view">
    Click `+` next to the view tabs.
  </Step>

  <Step title="Choose Calendar view">
    Select **Calendar view** from the view types.
  </Step>

  <Step title="Review date fields">
    Teable selects suitable date fields when available. Open **Calendar config** to change the **Start date field**, **End date field**, or **Title field**.
  </Step>
</Steps>

## Date Field Settings

| Setting          | Description                                              |
| ---------------- | -------------------------------------------------------- |
| Start date field | Controls which day the record appears on                 |
| End date field   | Shows records that span multiple days or have a duration |
| Title field      | Controls the text shown on calendar records              |

If the table does not have a date field, Teable may prompt you to add start and end date fields.

## Color Settings

Calendar records can use colors to separate different types of work.

| Color display      | Description                                                    |
| ------------------ | -------------------------------------------------------------- |
| Customize color    | Uses one fixed color for this Calendar view                    |
| Align with records | Uses colors from a Single Select field, such as status or type |

## Navigate the Calendar

* Use the left and right arrows to switch months.
* Click **Today** to return to the current date.
* Click a record on the calendar to open its details.

## Create and Adjust Events

* Hover over a date cell and click `+` to create a new record on that date.
* To create a multi-day item, set an end date in the record details, or drag the event edge when separate start and end date fields are configured.
* Drag an existing record to another date to update its date fields.
* Right-click a record to duplicate or delete it.

## Notes

* Calendar view depends on single-value date fields. If a configured date field is deleted or changed, review **Calendar config**.
* Calendar view changes how records are displayed. It does not change existing fields unless you choose to add date fields from the Calendar prompt.
* Create, edit, delete, drag, and resize actions depend on your view, record, and field permissions.
