A workspace contains tabs that provide you with easy access to different Relativity features, including documents, search terms reports, views, and other default functionality. Relativity is a highly customizable platform. Commonly used tabs can be added to the Sidebar so that they can conveniently be accessed at any time. To learn more, visit Navigation.

Note: RelativityOne includes a tool that allows you to choose a workspace to use as a source template for tab structure and then lets you apply that template across multiple workspaces in your instance. See Tab Sync.

You can also apply any workspace template with a tabs arrangement that best serves your review needs. Some workspace templates also include custom tabs for specialized functionality.

You can add custom tabs in workspaces or at Home. Users with admin rights also have access to a Tabs tab from Home. The functionality of this Tabs tab is the same as the Tabs tab in a workspace.

In addition, Relativity automatically creates a tab when you add a new object type.

This page contains the following sections:

See the following related pages:

Creating and editing tabs

To create or edit a tab, follow these steps:

  1. Click the Tabs tab.
  2. Click New Tab. If you're editing an existing tab, click the icon in the row of the tab you would like to edit.
  3. Complete the fields on the form. See Fields.
  4. Click Save.


Information on the fields in the Tab Information and Tab location are described below.

Tab Information

  • Name - the tab’s name. This field must be between 1 and 50 characters. Be as concise as possible when naming tabs.
  • Tab Type - determines the type of tab you want to create:
    • Object - creates a tab for a non-document object in your workspace.
    • Parent - establishes the tab as a parent tab. Existing tabs can then be set as children of the parent tab, which causes them to display in the Sidebar's fly-out menu or in the Tab strip when the parent tab is currently selected. To learn more, visit Navigation. Selecting this option changes the layout by hiding the Object Type and Set as Default fields.
    • External - link to any URL or object type in Relativity.
    • Note: Selecting External from the Link Type menu causes the Link field to appear below the Parent field. In the Link field, you can enter a web address to link to a URL.

      You can create a link from a tab to an Relativity Dynamic Object (RDO) or a script, using either an Artifact ID or GUID. To create links to other objects, you must use their GUIDs. For information about working with objects that don't have GUIDs, see Tabs.

      Use the following token to link to an object: ObjectArtifactIdentifier=[identifier], where [identifier] is the GUID of the object, or in the case of RDOs and scripts, the GUID or Artifact ID. For example, you would use the format ObjectArtifactIdentifier=736b1c1f-d22f-43cf-9094-cc8acf94c60 to create a link from a tab to the object with this GUID.

  • Use the following case insensitive text replacement options to customize the URL, allowing you to display current details about your workspace:

    Text Replacement Option Replacement Text
    %AppID% AppID=<Current Workspace ID>
    %ApplicationPath% The actual application path
    %ArtifactTypeID% ArtifactTypeID=<Current ArtifactTypeID>
    %AssociatedArtifactID% AssociatedArtifactID=<Current Instance Artifact ID>
    %AuthenticationToken% AuthenticationToken=<New Authentication Token>
    %ConnectorfieldArtifactID% ConnectorFieldArtifactID=<Current Connector Field Artifact ID>
    %ParentArtifactID% ParentArtifactID=<Current Parent ArtifactID>
    %SystemID% SystemID=<Current System ID>
    %SelectedSearchArtifactID% SelectedSearchArtifactID =<Current Search Artifact ID>

  • Object Type - determines which object’s information is displayed in the tab for those specified as Link Type = Object.
  • Set as Default Tab - toggle on to make this tab serve as the workspace’s default tab. Reviewers logging in to the workspace are taken to the default tab. If a reviewer does not have access to the default tab, he or she is directed to the Documents tab instead.
  • Visible - toggle on to display this tab from the Sidebar, Tab strip, and/or Quick nav. To learn more about these features, visit Navigation.
  • Relativity Applications - add this tab to a Relativity application. Clicking brings up a list of available applications.

Tab Location

  • Show in Sidebar - toggle on to add this tab to the Sidebar. Depending on the number of tabs that have already been added to the Sidebar, the Order value assigned to this tab, and your browser's resolution, the tab may be displayed in the More menu if it does not fit into the current Sidebar.
  • Parent - select a parent tab to assign the current tab as a child tab. The current tab will display in the fly-out menu for the parent tab.
  • Order - represents the position of the tab by a numerical value. It can be any positive or negative integer. You cannot use decimals in this field. The lowest-numbered tab displays at the top of the Sidebar. The highest-numbered tab displays at the bottom of the Sidebar or in the More menu. Items that share the same value are sorted in alphanumeric order.
  • Note: It’s always a good idea to set tab order by 10's, starting with 10, then 20, then 30, etc. By numbering in groups of 10 you can insert an item into any position later in the workspace, without the need to reorder (for example, you can use 10, 20, 25, 30, 40 to insert a new tab between 20 and 30).

Nesting children tabs

You may prefer to nest several tabs within a parent to reduce clutter in your Relativity interface and make tabs easier to locate. You must first specify a tab as a parent (step 1) and then specify children tabs (steps 2-4).

  1. Create a new tab with a Tab Type of Parent or edit an existing tab.
  2. Click the icon next to the tab you want to nest.
  3. Choose the parent tab name under the Parent drop-down menu.
  4. Click Save.

Repeat for each child tab you wish to nest. Hover your cursor over the parent tab to display the nested child tabs in a fly-out menu.