Use the navigation element to guide user exploration (Beta)

🚩

This documentation describes a public beta feature and is under construction. This page should not be considered part of our published documentation until this notice, and the corresponding Beta flag on the feature in the Sigma service, are removed. As with any beta feature, the feature discussed below is subject to quick, iterative changes. The latest experience in the Sigma service might differ from the contents of this document.

Beta features are subject to the Beta features disclaimer.

Add a navigation element to your workbook to display a list of destinations users can visit. The navigation element shows each destination as an individual button, which you can configure to send users to a workbook page, workbook element, or external link when clicked. Submenus allow you to nest additional navigation options under a top-level option.

The navigation element is a layout element, allowing you to guide users and create focused interfaces as you build data apps in Sigma.

Image of a navigation bar in a page header. A user clicks several options to navigate the workbook

Use a navigation element when you want to:

  • Provide a list of destinations for users to explore.
  • Hide the native workbook page navigation.
  • Link to workbook pages and external links in the same list of options.

To create a container with several tabs of content on a single workbook page, Use tabbed containers to organize workbook content.

To create a static page header that is shared by multiple pages, see Add custom page headers to a workbook.

User requirements

The ability to create and customize a navigation element requires the following:

  • You must be assigned an account type with the Create, edit, and publish workbooks permission enabled.
  • You must be the workbook owner or be granted Can edit access to the workbook.

Create a navigation element

Add a navigation element to your workbook:

  1. Open a workbook draft.

  2. In the Add element bar, select Layout, then select Navigation.

The Add elements bar with the Layout > Navigation option highlighted for selection

By default, the navigation element populates in Auto mode, listing the current workbook pages as the destination options. For example, if your workbook has pages titled Sales - East, Sales - West, and Raw Data, those three pages appear as options when you create a navigation element. For more information on customizing destination options, see Set manual navigation options.

Customize a navigation element

To customize the content or style of a navigation element, see the following sections:

Set automatic navigation options

You can set navigation options to automatically match the current workbook pages:

  1. Select the navigation element.
  2. In the editor panel, select Properties.
  3. Select Auto.

In Auto mode, the navigation element lists all current workbook pages as navigation options. Changes to the workbook pages (new pages, renamed pages, deleted pages) automatically appear in the navigation element. Hidden pages do not appear as navigation options.

💡

Any customization requires you to convert the navigation element to manual mode. See Set manual navigation options.

Set manual navigation options

You can manually set a list of navigation options including custom destinations, names, and nesting.

Set a navigation element to manual:

  1. Select the navigation element.
  2. In the editor panel, select Properties.
  3. Select Manual.
📘

Setting a navigation element to Manual stops automatic updates from changes to workbook pages. This allows you to set the navigation options independent of the current workbook pages.

To add a new navigation option:

  1. Select the navigation element.
  2. In the editor panel, select Properties.
  3. Select Manual.
  4. Click Add an option and select an option from the menu:
Submenu titleAdd a title with nested navigation options in a submenu. The submenu title itself is not a navigation option.
Main pageAdd an option that navigates to a selected workbook page.
Page anchorAdd an option with a navigation action and no specified destination. Configure the destination to navigate to any workbook page or element.
LinkAdd an option that navigates to an external link. Configure a static or dynamic link URL, and select whether the link opens in a new window, the current window, or the parent window.

Edit a navigation option:

  1. Select the navigation element.
  2. In the editor panel, select Properties.
  3. Select Options for the navigation option you want to edit and select an option from the menu:
Edit destinationChange the destination for the navigation option.
RenameChange the name of the navigation option.
DuplicateDuplicate the navigation option.
DeleteDelete the navigation option.
Move toMove the option to another location in the navigation element. Selecting an existing option transforms that options into a submenu title. The option you moved appears under that submenu title.

Style a navigation element

You can configure the padding, background color, and corner style for a navigation element:

  1. Select the navigation element.
  2. In the editor panel, select Format.
  3. Expand the Element style section to view the style settings.
  4. Configure the style settings:
PaddingOn by default. Enable or disable the space between the border of the navigation element and its contents.
Background colorSelect the color displayed behind the contents of the navigation element.
CornerSelect whether to have square, round, or pill-shaped corners for the navigation element.

You can configure the corner style, orientation, alignment, and size of the options in a navigation element:

  1. Select the navigation element.
  2. In the editor panel, select Format.
  3. Expand the Option style section to view the style settings.
  4. Configure the style settings:
CornerSelect whether to have square or pill-shaped corners for the navigation element.
OrientationSelect whether to display the navigation options horizontally or vertically.
AlignmentSelect whether to left align, center align, right align, or stretch the navigation options.
SizeSelect whether the navigation options are small, medium, or large.

Create a nested submenu of navigation options

In a manual navigation element, you can configure a nested submenu of navigation options.

An open navigation submenu titled Teams shows options for Marketing, Engineering, and People
  1. Select the navigation element.
  2. In the editor panel, select Properties.
  3. Select Options for the navigation option you want to add to the submenu.
  4. Select Move to.
  5. Select an existing submenu or create a new one by selecting another navigation option.
  6. Repeat steps 3-5 for each navigation option you want to add to the submenu.

Alternatively, you can drag and drop a navigation option under another navigation option in the editor panel to create a submenu.

A navigation option is dragged and dropped under another navigation option to create a submenu.
📘

The title of a submenu is not a navigation option. Sigma recommends creating an empty navigation option to move other options into.

Delete a navigation element

You can delete a navigation element directly from the workbook page:

  1. Select the navigation element.
  2. Click More.
  3. Select Delete element.

Hide page tabs in view mode

You can hide the workbook page tabs from users in view mode, allowing you to set a navigation element as the primary navigation for your workbook.

To hide the workbook page tabs in view mode:

  1. Select the workbook page.
  2. In the editor panel, under Settings, select Workbook settings.
  3. Open the Layout settings.
  4. In the Layout settings section, check the box next to Hide page tabs in view mode.
  5. In the confirmation modal, click Confirm.
🚩

After hiding the page tabs, users won’t be able to change pages without a navigation element or navigate action. Consider this user experience before hiding the page tabs.