Gantt

Use the Gantt view to plan sprints, track roadmaps and manage dependencies, all from the table you already use. The Gantt view turns a date-based table into a live project schedule. Records are bars on a timeline that you can drag. Dependencies are arrows between the bars. Key dates are milestone diamonds.

Drag a bar to reschedule it. Resize a bar to make it longer. Drag from the handle of a bar to link tasks. Zoom from a one-week sprint to a five-year roadmap in the same view.

This section gives all the operations for the Gantt view.

Gantt View Actions

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

Configure Gantt Schedule

The Gantt view draws bars and arrows from a Date Dependencies rule. Each view has its own rule. When you open a Gantt view for the first time, the Configure Gantt Schedule dialog opens automatically. Select the fields for the chart in this dialog.

The dialog has these fields:

When you select a Successor Link, a Propagation section shows (PostgreSQL and MySQL bases only). Use it to set how date changes cascade across linked records:

To open the dialog again later, click Configure in the toolbar.

Empty state

If the rule is not set, or its Start / End Date fields are deleted, the Gantt view shows an empty state. The empty state has a Configure Date Dependencies button. This button opens the same dialog.

Zoom Levels

The Gantt view has eight zoom levels, from a one-week sprint view to a five-year roadmap. To change the zoom level, use the zoom selector in the toolbar.

At wider zoom levels, the date header shows multiple tiers, for example year over quarter over month. This helps you find your position when you see a longer span.

Navigation

Time Navigation

• To move backward or forward by one step of the active zoom level, use the Previous and Next buttons in the toolbar.
• To go to the current date, click the Today button.
• To go directly to a specific date, use the Date Picker dropdown.

Scrolling

• Horizontal scrolling moves across time. Records load as you scroll. You can look through months or years and do not have to go to a specific date.
• Vertical scrolling is available when there are more records than the visible height. In grouped layout, each group scrolls in the groups list. The date header stays fixed at the top.

Record Navigation

When a record bar goes past the visible area, navigation arrows show on the bar:

Click an arrow to go to the related date.

When you click a record in the left sidebar and its bar is fully off-screen, the date axis moves to the bar. If a part of the bar is visible, the timeline does not move. This way, vertical scrolling does not change your horizontal position.

Record List Sidebar

The left sidebar lists all records in the view. The sidebar is collapsible (click the chevron at the top of the sidebar) and resizable (drag its right edge). NocoDB keeps the width and the collapsed state across sessions.

When you collapse the sidebar, it becomes a narrow "Show Sidebar" stub. The chart can then use the full width.

To open the Record Inspector for a record, click the record in the sidebar.

Bars and Milestones

Task bars

A record with a start date and an end date shows as a horizontal bar from start to end. Hover over a bar to see a tooltip with the record title, date range and duration.

Milestones

A record with only an end date (start date empty) shows as a diamond in the end-date column. A milestone:

• Shows in the sidebar. A small diamond marker on the right edge of the row identifies it, also when the bar is off-screen.
• Can be a predecessor or a successor in a dependency chain.
• Can move to a different date when you drag it, the same as a bar.

Each milestone also has a light dashed vertical guide line from the date header down to the milestone diamond. This line is like the "today" line. It lets you quickly read the date of the milestone on the header.

In the example below, the selected Design Sign-off milestone shows its dashed guide line up to the date header. The record inspector shows that it is a milestone with only an end date:

Edit Record Dates

Drag to Move Click and hold a bar for a moment. Then drag it to a new date. The start and end dates move by the same number of days, so the duration stays the same. To change the end date of a milestone, drag the milestone.

Drag to Resize Hover over the left or right edge of a bar. A resize handle shows.

• To change the start date, drag the left edge.
• To change the end date, drag the right edge.

Dependencies

When you set a Successor Link field, the Gantt view draws arrows from each record to the tasks that it points to (its successors).

Create a dependency

1. Hover over a bar. A small circular dependency handle shows at the bottom-right corner (bottom tip for milestones).
2. Drag from the handle onto another bar. While you drag, the cursor draws an L-shaped preview. When you release, NocoDB creates the link.

Highlight the chain

When you hover over a bar or milestone, its entire connected dependency chain gets a green outline, upstream and downstream. When the inspector is open, the chain of the inspected record stays highlighted. This keeps your context while you scroll.

Remove a dependency

Click the dependency arrow to select it. Then press Delete. Or, remove the link from the Record Inspector.

Record Inspector

When you click a bar, milestone or sidebar row, the Record Inspector opens in a panel on the right. While you look at one record in the inspector, you can continue to move and zoom the chart.

The inspector shows:

• A Record or Milestone badge and the date range.
• The primary field (record title), editable inline.
• Start Date, End Date, and Days (computed) fields. Click a date to open a picker.
• Predecessors section: all records that point to this record. To add a record, click + Link record. To remove a record, click the × next to its chip.
• Successors section: all records that this record points to. It has the same link / unlink controls.

In the inspector, Formula fields with a URL output show as clickable links.

To open the full expanded record form for the same record, click the Expand icon in the inspector header. Press Esc to close an open picker first, then the inspector.

A second click on the same bar (the bar that the inspector shows) opens the full expanded form directly. Other views use the same two-step pattern.

Add New Records

There are two ways to add records in the Gantt view:

Using the Add Button Click the floating + button at the bottom-left of the chart. NocoDB creates a new record with the start and end dates in the visible date range. The expanded record form opens.

Drag to Create To create a new record, drag on an empty area of the Gantt grid:

1. Click the start date and drag to the end date. A dotted rectangle shows the date range that you select.
2. Release the mouse button. NocoDB creates the record. The expanded form opens with the start and end dates filled in.

Customize Record Label

You can change the fields on the record bars. In the toolbar, click the Fields menu. Then:

• Turn fields on or off to set the fields on the bars.
• Drag fields to change their order.
• Apply text formatting (Bold, Italic, Underline) to individual fields.

Grouping Records

To group records by one or more fields, use the Group By option in the toolbar. When grouping is on:

• The records are in collapsible groups in the left sidebar.
• Each group shows its own chart segment and its number of records.
• The date header stays fixed at the top while the groups scroll vertically.
• Dependency arrows that cross groups show above the groups list. This keeps chains visible across group boundaries.

Each group-by entry in the Group By menu has an enable/disable toggle. Use it to turn a grouping off and on again. The grouping keeps its configuration.

Visual Indicators

Shared and Public Views

To share a Gantt view, use the standard Share View flow. In a public / shared view:

• Bars, milestones and dependency arrows show as usual.
• The Record Inspector is read-only. You cannot edit the name and date fields, and the Link record / Unlink controls are hidden.
• Bar drag, resize and the dependency handle are disabled.

Other Toolbar Operations

1. Apply Filters to Display Specific Records on the Gantt
2. Perform Quick Searches for Specific Data Within Fields
3. Export Data to CSV or Excel Format
4. Apply Row Coloring Based on Field Values

Availability

• The Gantt view is available on NocoDB Cloud (Business plan and above) and licensed self-hosted deployments (Business plan and above).

Related

Timeline View Calendar View Date Dependencies Grid View