Calendar

Learn how to work with Calendar view in NocoDB.

Calendar View allows you to visualise your data in a calendar format. You can easily rearrange the records by dragging and dropping them to different dates. You can also visualise the records in a day, week, 2 weeks, month, 6 weeks, or year format. This section will cover all the operations that can be performed on the Calendar view.

1010-2 Calendar

Calendar View Actions

  1. Create a New Calendar View
  2. Rename an Existing Calendar View
  3. Duplicate a Calendar View
  4. Remove a Calendar View
  5. Share a Calendar View
  6. Lock Calendar View for Edits

Timescales

For Calendar view, NocoDB supports 8 different timescales. Choose one from the timescale dropdown in the toolbar.

calendar-view-modes

Day

In day view, you can see the records for a single day. For records with DateTime fields, you can drag and drop the records to different timeslots within the day.

day-view

3 Days

In 3 days view, you can see the records across a three-day span in one focused frame, a layout that sits between Day and Week. Records are ordered by their scheduled time, and you can drag and drop them to a different day or, for records with DateTime fields, to a different timeslot to reschedule.

Week

In week view, you can see the records for a single week. You can drag and drop the records to different days within the week. For records with DateTime fields, you can drag and drop the records to different timeslots within the day. Each record card can display multiple fields at once, and the DateTime card hover tooltip shows field names alongside their values. When a record has more non-empty visible fields than the card can show, a +N more line indicates how many additional fields are hidden.

week-view

2 Weeks

In 2 weeks view, you can see the records for a two-week span at once. You can drag and drop the records to different days within the span.

2-week-view

Month

In month view, you can see the records for an entire month. You can drag and drop the records to different days within the month.

month-view

6 Weeks

In 6 weeks view, you can see the records across a six-week span, useful for planning beyond a single month. You can drag and drop the records to different days within the span.

6-week-view

Year

Year view allows you to see a birds-eye view of the records for the entire year. Blue badge on the date indicates that there are records on that date. You can click on the date to see the records for that date.

year-view

Custom

The Custom timescale lets you set your own span instead of using one of the fixed options. Open the timescale dropdown, click Custom…, then in the Timescale config enter a count from 1 to 6 and choose a unit of Days or Weeks. Click Set to apply. The dropdown trigger then shows your chosen span, for example 2 Days or 3 Weeks. Your custom span is remembered per view.

When the unit is Weeks, the weekend display options (Show, Collapse, Hide weekends) described below are available, just as in the week-or-longer timescales.

In the Week, 2 Weeks, Month, and 6 Weeks timescales, hold Shift while clicking the previous or next arrows to move a full week at a time. Your selected timescale is remembered per view.

Weekend Display

In the week-or-longer timescales (Week, 2 Weeks, Month, 6 Weeks), the view-mode dropdown offers three options for how weekends are displayed:

  • Show weekends: Saturday and Sunday are shown at full width alongside weekdays.
  • Collapse weekends: Saturday and Sunday are shown narrowed and merged, so they take less horizontal space while remaining visible.
  • Hide weekends: Saturday and Sunday are removed from the calendar entirely.

Weekend display options

With Collapse weekends selected, the Saturday and Sunday columns are narrowed so they take less space while staying visible:

Collapsed weekends

Record Height

Use the Record Height control in the toolbar to choose how much vertical space records take up. This mirrors the Record Height control in Grid view.

It is always available in the 2 Weeks, Month, and 6 Weeks timescales. In the 3 Days and Week timescales it appears only when the start field is a Date field.

  • Compact (View fits to screen): The default. The calendar fits within the screen height. In month view, surplus records collapse into a +N more popover, and in week view the cell scrolls to reveal additional records.
  • Expanded (View fills to show all records): Cells grow so that every record is visible, and the calendar body scrolls vertically as needed.

Record height options

Event Themes

Event themes are available on NocoDB Cloud paid plans and licensed self-hosted deployments.

Use the Event theme picker (the palette icon in the calendar toolbar) to control how event chips are drawn on the calendar. Choose one of five styles. Your choice is saved per view.

Bordered (default): Outlined chip with a colour bar.

Bordered event theme

Dot: Colour dot with plain text.

Dot event theme

Solid: Filled block in the event colour.

Solid event theme

Minimal: Colour bar with no border or fill.

Minimal event theme

Pill: Time shown as a colour pill.

Pill event theme

Pill is available only for date-time start fields. On a date-only calendar it appears disabled.

Event colours come from the record colouring feature. Events without a row colour fall back to a neutral grey.

Calendar View Operations

Customize Record Label

You can customize the record label that appears on the calendar. To do this, click on the Fields menu on the toolbar. In the dropdown that appears

  • Use toggle to enable or disable the fields that you want to display on the calendar.
  • Use reorder to change the order of the fields that you want to display on the calendar.
  • Use format menu options to customize the display of the fields on the calendar. You can choose to format the field as Bold, Italicise or Underline.

fields-menu

Add New Records

To add a new record to the calendar, click on the + icon to the bottom right of the calendar. Alternatively, you can also double-click on the white space in the calendar to add a new record. In the form that appears, fill in the details and click on Save.

Expand Record Details

To view the details of a record, click on the record. This will expand the record and show all the details of the record.

Edit Record Details

Use drag and drop to move the record to a different date or time. To edit any other details of a record, click on the record to expand it. Edit the details of the record. Make the necessary changes and click on Save.

Delete Record

To delete a record, click on the record to expand it. Click on the Delete button from the record context menu. Confirm the deletion by clicking on Delete in the confirmation dialog.

Configuring Date Range

Calendar date range (end date) is available on NocoDB Cloud (Plus plan and above) and licensed self-hosted deployments (Business plan and above).
date-range

In NocoDB, you can configure the date range display in the calendar view by selecting Start and End date fields. To specify the date range while setting up the calendar view, click on + End Date and choose the desired date field to serve as the end date. This displays the records in the calendar view as a range block between the start and end date.

date-range

date-range

The date range configuration is currently supported only for the Date field type. Support for DateTime field type will be added in the future

Alternatively, you can also configure the date range display functionality during view creation. To do this, click on + Add Field and choose the desired date field to serve as the end date.

date-range

Once the date range display is enabled, you can drag drop the records to change the start and end dates of the records. You can also resize the records to change the duration of the records.

Other toolbar operations

  1. Apply Filters to Display Specific Records on the Calendar
  2. Sort Records on the Calendar by One or More Criteria
  3. Perform Quick Searches for Specific Data Within Fields
  4. Export Data to CSV, JSON, Excel, or iCalendar (.ics) Format