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. You can apply any 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. If you are developing a custom application, you may want to obtain the globally unique identifier (GUID) for a tab. For information about obtaining GUIDs, see Basic concepts for the application framework on the Relativity Server 2021 Developers site.

This page contains the following sections:

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 Edit.
  3. Complete the fields on the form. See Fields.
  4. Click Save.


  • Name - the tab’s name. This field must be between 1 and 50 characters. Be as concise as possible when naming tabs.
  • 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 is the leftmost tab. The highest-numbered tab is the rightmost tab. 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).

  • View Order - displays a list of active tabs and their current order when you click View Order.
  • Link Type - determines the type of tab you want to create:
    • Object - creates a tab for a non-document object in your workspace.
    • External - link to any URL or object type in Relativity.

      • 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.
      • Allowed external domains can be whitelisted via the DomainNameWhiteListUrls instance setting.

      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 Assigning a GUID to an object.

      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 OptionReplacement 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>

    • Parent - establishes the tab as a parent tab. Existing tabs can then be set as children of the parent tab, thereby creating a drop-down tab structure. Selecting this changes the layout by hiding the Parent, Object Type, and Is Default fields and bringing up the required Tab Display field.
  • Parent - the tab is placed as a child tab in the drop-down list of any parent tab.
  • Object Type - determines which object’s information is displayed in the tab for those specified as Link Type = Object.
  • Is Default - the tab to serves 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.
  • Is Visible - select this tab from the tab menu.
  • Relativity Applications - add this tab to a Relativity application. Clicking ellipsis button brings up a list of available applications.

Nesting 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 Link Type of Parent or edit an existing tab.
  2. Click the Edit link 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 tab you wish to nest. Nested tabs reside in the drop-down menu of the parent. The tab disappears from the tab strip and reside below the new tab.

tab dropdown

Assigning a GUID to an object

You need to assign a GUID to a Relativity object that only has an Artifact ID, before you can link a tab to it. To assign a GUID to an object, you run a SQL script on database for the workspace where the object resides. This script adds this identifier to the record for the object on the Artifact.Guid table in the database.

You need to complete this assignment process for all Relativity objects except for the following cases:

  • RDOs and scripts - you can link these objects to tabs using their Artifact IDs or GUIDs, if available. See Creating and editing tabs.
  • Objects in applications - Relativity automatically assigns GUIDs to objects added to applications. For information about obtaining their GUIDs, see Viewing component GUIDs on the Relativity Server 2021 Developers site.

Use the following procedure to assign a GUID to an object:

  1. Obtain the Artifact ID for an object from the URL used to access it, or by adding the Artifact ID field to the list view for the object in Relativity. See Views.

    Artifact ID in a URL

  2. Log in to your database server. You must be a database admin.
  3. Locate the workspace database for the object that requires a GUID.
  4. Execute the following SQL script on the workspace database for the object:

    DECLARE @artifactID int = 0 -- Your artifact that is missing a GUID.
    IF NOT EXISTS (SELECT 1 FROM EDDSDBO.[ArtifactGuid] WHERE ArtifactID = @artifactID)
        INSERT INTO EDDSDBO.[ArtifactGuid] VALUES (@artifactID, NEWID())
    SELECT [ArtifactGuid] FROM EDDSDBO.[ArtifactGuid] WHERE ArtifactID = @artifactID

  5. Assign the GUID added to the database to the ObjectArtifactIdentifier token to link a tab to the object. See Creating and editing tabs.