Skip to content
Release: Australia · Updated: 2026-03-12 · Official documentation · View source

Timeline sub item

Use the Timeline Sub Items related list to define child spans for the timeline, based on records in a table that references the parent timeline's table.

About this task

You can create a timeline sub item generate a hierarchical relationship, starting from a timeline page to any number of levels. For example, if there is a timeline page for a release, the sub item might be sprints, and the sprint might have stories as a sub item.

Procedure

  1. Navigate to All > System UI > Timeline Pages.

  2. Open the timeline page for which you want to add a sub item.

  3. Go to the Timeline Sub Items related list and click New.

  4. Fill in the form (see table for field descriptions) and click Submit.

FieldDefinition
Parent\[Read-only\] Identifies the parent of the timeline sub item.
NameEnter a unique name that describes the function of this timeline. For example, Sprints for late Priority Changes.
TableSelect the table called by this timeline. The selected table must contain at least one field that references the table you selected for the parent timeline page. For example, if the parent timeline page uses the Scrum Release \[rm\_release\_scrum\] table, you might choose the Sprint \[rm\_sprint\] table for a timeline sub item.
Start date fieldSelect a time-related field from the specified table to use as the start date for the timeline. For example, Planned start date.
End date fieldSelect a time-related field from the specified table to use as the end date for the timeline. For example, Planned end date.
Parent Reference ColumnSelect a reference field on which to base the timeline connection between the sub item records and the parent records. - If multiple reference fields are available, choose the reference field that forms part of the hierarchy modeled by this timeline. - If this list is blank, the sub item table contains no reference fields to the parent table. In this case, you must choose a different table for the sub item. ServiceNow uses the parent reference column to determine which records appear at each level of the timeline.
Display Options
CSS span colorEnter a custom span color using any CSS color format, such as RGB or hexadecimal. If this field is blank, it uses the default span color, light blue. The dark blue color indicates tasks with a planned start date only, with no planned end date. Adding a planned end date updates the color to light blue.
Span text fieldsSelect fields from the specified table to have those values appear as span labels. For example, you might select Number and Short description. If the timeline displays the left pane, span labels also appear in the left pane
Tooltip text fieldsSelect fields from the specified table to have those values appear as tooltips. For example, you might select Category, Assigned to, and Due date.
Filtering and Sorting
Condition builderCreate a condition to filter the results that appear in the sub item. For example, you might create a condition that displays only active, high priority incidents.
Perform custom sortSelect this check box to enable custom sorting. Configure the sort order by selecting fields in the Sort by andSort by order fields.
Sort bySelect any field in the list for sorting the spans in the timeline. Common practice is to select either the Start date field or the End date field as the sorting field. If you select a different sorting field, also include that field in the list of tooltip text fields to give users a way of discovering the sort criteria.
Sort by orderSelect the sort order for the sorting fields selected.
Interactive options
Allow horizontal moving?Select this check box to permit users to drag timeline spans horizontally. Dragging changes the start and end dates and updates the record.
Allow start time dragging?Select this check box to permit users to update the record by dragging the start time of a span.
Allow end time dragging?Select this check box to permit users to update the record by dragging the end time of a span.
RestrictionSpecify the behavior when you drag a child span. This option is available only if you did not specify Range calculator for the parent timeline page.- None: No restriction is in place. - Restrict by parent: Move the child span only within the time frame defined by the parent span. - Update parent: Update the span when you move the child span outside the time frame defined by the parent span.

Parent Topic:Timeline pages