---
sourceDocument: Australia Build or modify applications
sourceDocumentLink: https://www.servicenow.com/docs/r/application-development

 Release :

    - australia

ft:locale :

    - en-US

ft:publication_title :

    - Australia Build or modify applications

ft:clusterId :

    - cadev

bundleId :

    - cadev

workflow :

    - Development, Data, and Analytics


---

# Edit a workspace

# Edit a workspace in Workspace Builder {#ariaid-title1}

* Release version: Australia
* 
* Updated March 12, 2026
* 
* ![](https://www.servicenow.com/docs/portal-asset/ico-clock) 2 minutes to read

Edit a workspace in Workspace Builder to make customizations.
This video shows you how to perform the following procedure.

<br />

## Before you begin

Before you can configure a workspace in Workspace Builder, you must first create the workspace. See [Add a workspace](https://www.servicenow.com/docs/ISZpTHJOTtJabtpL107XMw "Create a workspace using Workspace Builder in ServiceNow Studio or App Engine Studio (AES). Workspaces provide agents, case managers, help desk professionals, and managers with tools to help answer customer questions and resolve customer problems.").  
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](https://www.servicenow.com/docs/0skBHMQYAvsoGnK2SmR32g "Delegated development enables designated users without a system admin role to develop or deploy applications on the ServiceNow AI Platform. This enables administrators and delegated developers to work together to deliver custom applications through App Engine Studio (AES).").
{#configure-workspace-builder__ul_ggl_415_bgc}

## About this task

You can customize essential elements and components in Workspace Builder. For more complex configurations, or if you don't have the full entitlement for AES, you must edit the workspace in UI Builder.

## Procedure

1. Navigate to Workspace Builder.  
   For details on how to open Workspace Builder in ServiceNow Studio or AES, see [Accessing Workspace Builder](https://www.servicenow.com/docs/swS8qmgXFE~CYgXoFh2aEQ "You can access Workspace Builder in both ServiceNow Studio or App Engine Studio (AES).").  
   The Workspace Builder tab displays your workspace within AES:
   * The left navigation panel is a list of pages or components, or building blocks of a page, that you can include in your workspace.  
     Note:  
     The home page is an essential part of the workspace, and thus can't be hidden or removed.
   * The middle canvas is an in-line editing space for the home page for workspaces created in AES after Tokyo. For lists and other pages, the middle canvas is a preview of what you configure in the right configuration panel. You can preview workspace home pages built before Tokyo in Workspace Builder, but you must edit them in UI Builder.
   * The right configuration panel is the configuration panel for working with selected components.
   {#configure-workspace-builder__ul_q4j_rbx_wtb}

   If you created the workspace that contains a technical dashboard, Workspace Builder prompts you to Open in UI Builder when you try to edit the workspace.
2. Edit the basic settings for the workspace by selecting Workspace settings.  
   For more information, see [Configure workspace settings in Workspace Builder](https://www.servicenow.com/docs/X5XRbJPMFRa_7tvMctz4NQ "Define workspace settings in Workspace Builder to control the basic functionality of the workspace, such as name and record page navigation.").
3. Adjust the home page elements and widgets by resizing, reorganizing, or reconfiguring them.  
   For more information on editing a clickable home page, see [Customize a workspace home page in Workspace Builder](https://www.servicenow.com/docs/iRA~occa1_rpJpcYcMwKOw "Edit the home page for a workspace in Workspace Builder. Adjust what users see when first accessing the workspace, which is a dashboard.").  
   Note:  
   If the workspace was created before Tokyo, you must edit it in UI Builder. See [UI Builder](https://www.servicenow.com/docs/eEkHP5JM3Z7MG7voCBC~XA "UI Builder is a web user interface builder. Use UI Builder to build pages for App Engine Studio generated workspaces or custom web experiences using Next Experience Components and custom web components.") for more information. {#configure-workspace-builder__adjust-workspace-inline}
4. Add or edit a list category and any subsequent filtered lists.  
   For more information, see [Create lists for a workspace in Workspace Builder](https://www.servicenow.com/docs/ag3yYXbNAbHmgeJMWRrqOA "Create list categories in Workspace Builder to add pages that list table records. You can add filter conditions and change columns to create variations on the list.").
5. **Optional:** Enable an Analytics Overview for the workspace.  
   For more information, see [Enable analytics for a workspace in Workspace Builder](https://www.servicenow.com/docs/oJgp9sAd5UbwPhsRt85QEg "Enable the Analytics Overview for a workspace in Workspace Builder. The Analytics Overview enables users to track and analyze records and usage with dashboards, data visualizations, and insights on the instance.").
6. Add and edit a record page to configure the settings, tables, and related links that the workspace should support.  
   When you create a record page, you're creating the metadata view, or shell, using a record page template for a type of record. You then edit the record page in Table Builder. Within Workspace Builder, you can only change the contextual side panel and the related items.

   For more information, see [Add a record page for a workspace in Workspace Builder](https://www.servicenow.com/docs/9iovm9iGFVFTh0J2oO5CjQ "Configure a record page for a workspace in Workspace Builder. Use containers and components to guide a user through an experience. Each record page is linked to only one data table.").
7. Preview the workspace in a new browser tab by clicking Preview.

## Result

If you made additional, more complex configurations to the workspace in UI Builder, such as custom additions to the contextual side panel or custom components, those changes may not appear in Workspace Builder.  
Note:  
Your workspace must have a home page and lists for you to edit it in Workspace Builder. If they aren't present, you must edit the workspace in UI Builder.