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

Configure workspace settings in Workspace Builder

Define workspace settings in Workspace Builder to control the basic functionality of the workspace, such as name and record page navigation.

This video shows you how to perform the following procedure.

Before you begin

Role required:

  • admin or Guided Application Creator for ServiceNow Studio.
  • sn_app_eng_studio.user or delegated_developer for AES. For more information, see Delegate developers using AES.

Procedure

  1. Navigate to Workspace Builder.

    For details on how to open Workspace Builder in ServiceNow Studio or AES, see Accessing Workspace Builder.

  2. Display the Settings form by selecting Workspace settings in the Workspace Builder header.

Image omitted: wb-settings-dialog-new-theme.png
Define settings for your workplace
  1. On the General tab of the form, specify or change the basic settings for the workspace by filling in the editable fields.

    Note: Some settings are specified when adding a workspace, and can't be changed.

FieldDescription
NameName for the workspace, which is visible to users.
URLRelative URL for the workspace. The path is automatically created based on the name of your workspace, and is preceded by your instance URL. However, you can customize the path in this field.
DescriptionBrief description of the purpose of the workspace.
User accessPeople and groups that can access the workspace. To give unrestricted access to the workspace, leave this field empty.
Search configuration

Source of information when users perform a search in the workspace. You can reuse an existing search configuration by selecting the profile from the menu. Select the Edit search application link to make additional, advanced configuration changes.If you select an AI Search profile, the following features are available:

  • Selection of multiple facet values simultaneously, which you can apply using the condition builder.
  • Ability to view parent documents with linked attachments, which you can download.
  • Dark mode. Note: AI Search must be enabled for your instance to select an AI Search profile.

For more information, see AI Search.

Show tables included in search configurationOption that displays one or more tables that the workspace searches as sources.
Workspace themeTheme to define the visual style of the workspace, which you can select only if Polaris isn't enabled for the instance. Themes are retrieved from the UX Themes [sys_ux_theme] table..
Add only one **User access** role at a time. For more information, see this [Knowledge article](https://support.servicenow.com/kb?id=kb_article_view&sysparm_article=KB1561167).
  1. Select Save.

  2. Specify what type of records users can create by selecting the Record navigation tab of the form and then filling in the fields.

FieldDefinition
Navigation type

How users interact with or navigate the workspace. Tabbed navigation creates separate tabs for each page, enabling users to work on multiple records at a time. Choose tabs if you anticipate that users must change between records quickly. Tabs also enable users to create records directly from the navigation.

Note: The default navigation type for workspaces built in AES is tabbed, and can't be changed after the workspace is created. You must create the workspace in UI Builder to specify breadcrumb navigation. You can't change the navigation type after the workspace is created.

Table

Data table that is added to when a user creates a record. The table you select automatically has associated lists.Note: The tables specified when the workspace was created appear automatically. Select Add a table to incorporate additional tables into the workspace. You can add each table only once.

To remove a table, select its delete icon (

Image omitted: trash-icon.png
Delete a table from record navigation). No confirmation message appears, but you can select <strong>Cancel</strong> to revert the deletion.</p></td></tr><tr><td>
Label
Brief label for the option that appears when users select the new record menu. Specify a label that tells users what the record is used for.
  1. Select Save.