---
title: "Create a Timebar Object"
slug: "create-a-timebar-object"
description: "Learn how to add a Timebar Object in Board: choose Time Entities, define granularity and range, set display type, and connect it with Screen Objects."
tags: ["Objects", "Developer", "Timebar", "Design Mode", "Layout"]
updated: 2025-11-06T14:28:00Z
published: 2025-10-30T07:39:49Z
canonical: "help.board.com/create-a-timebar-object"
---

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

# Create a Timebar Object

This topic describes how to add a new Timebar Object to a Screen or a Container and its specific properties.

To create a new Timebar Object, you need to open a Screen in Design Mode.

Once you're in the Screen editing page, locate the Timebar Object from the Screen Objects list in the [left panel](/v1/docs/design-and-play-mode#left-panel), then drag and drop it onto your Screen or Container.

![contents/assets/images/timebar obj creation.gif](https://cdn.document360.io/8d6f1ae8-0cac-4d0d-a208-6245b83df94a/Images/Documentation/creating-a-timebar-object-image-jt89n477.png)

When you create a Timebar Object, it is initially empty. The next step is to configure a Layout that will define the time range to be displayed. To do so, click the center of the Object or select it and click the "Configure Layout" button ( ![contents/assets/images/layout.png](https://cdn.document360.io/8d6f1ae8-0cac-4d0d-a208-6245b83df94a/Images/Documentation/creating-a-timebar-object-image-tc0h459u.png) ) in the Properties Toolbar located vertically alongside the Properties panel to the right of the Screen.

![contents/assets/images/timebar.layout.png](https://cdn.document360.io/8d6f1ae8-0cac-4d0d-a208-6245b83df94a/Images/Documentation/creating-a-timebar-object-image-7lydhnol.png)

See [The Layout Object](/v1/docs/the-layout-object), [Configure a Layout](/v1/docs/configure-a-layout), and [About Data Blocks of a Layout](/v1/docs/about-data-blocks-of-a-layout) for more details on the Layout Object.

The Timebar Object, just like every other Object, can be moved, resized, duplicated via copy/paste, and easily aligned with other Objects on the Screen.

See [Configure Screen Objects](/v1/docs/configure-screen-objects) for more details.

## Timebar Layout

The Layout editor for the Timebar Object is slightly different from [the classic one](/v1/docs/about-the-layout) in that it offers some specific options and properties. The main differences are highlighted in the image below:

![contents/assets/images/timebar.layout.differences.gif](https://cdn.document360.io/8d6f1ae8-0cac-4d0d-a208-6245b83df94a/Images/Documentation/creating-a-timebar-object-image-64mzvx5r.png)

### The Axes area

In the Axes area, you can define the Time Entity that will be used to plot the area sparkline chart.

> [!NOTE]
> *The Timebar Object supports and requires only one Time Entity in the By Row field. The Timebar Object doesn't support Entities By Column. Properties in the Axes area settings menu shown below are available, but any change made during the Layout configuration is ignored. ![contents/assets/images/Treemap.axes.properties.PNG](https://cdn.document360.io/8d6f1ae8-0cac-4d0d-a208-6245b83df94a/Images/Documentation/creating-a-timebar-object-image-x54688ff.png)*

### Object settings

In the Object settings within the Layout editor, the **Sparkline Block menu** allows you to configure which Block will be used to plot the area sparkline chart in the Timebar; simply click on the field and select one of the suggested Blocks.

> [!NOTE]
> *Hidden Blocks will not appear in the suggestion panel.*

![](https://cdn.document360.io/8d6f1ae8-0cac-4d0d-a208-6245b83df94a/Images/Documentation/timebar.hidden.sparkline.block(1).png)

## Timebar properties and settings

Timebar properties are available from the [Object Properties panel](/v1/docs/design-and-play-mode#object-properties-panel) to the right of the Screen editing page once the Object is selected.

The Object supports all [options common to all Screen Objects](/v1/docs/about-screen-objects#options-common-to-all-screen-objects) and has only one specific property: **Show inactive**.

![contents/assets/images/show inactive.png](https://cdn.document360.io/8d6f1ae8-0cac-4d0d-a208-6245b83df94a/Images/Documentation/creating-a-timebar-object-image-u1blp9ku.png)

If enabled, **Show inactive** allows the Planners in Play Mode to extend the selection to members not included in the default Screen Selection.

If disabled, the Show inactive property denies Planners in Play Mode the ability to select members not included in the default Screen Selection.

See [About the Select](/v1/docs/about-the-select) for more details.

## Interacting with the Timebar Object in Design Mode

In Design Mode, the Timebar Object provides the same [interactive features available in Play Mode](/v1/docs/interacting-with-a-timebar-object).

Be aware that, if you apply a Selection in Design Mode and save the Screen, that Selection will be applied to the Screen in Play Mode by default. Depending on the configuration of the "Show inactive" property described in the previous paragraph, Planners in Play Mode will be able to extend the Selection to members not included in the default selection or not.