---
sourceDocument: Yokohama Build or modify applications
sourceDocumentLink: https://servicenow-prod.fluidtopics.net/r/yokohama/application-development

 Release :

    - yokohama

ft:locale :

    - en-US

ft:publication_title :

    - Yokohama Build or modify applications

ft:clusterId :

    - cadev

bundleId :

    - cadev

workflow :

    - Development, Data, and Analytics


---

# Configure a workspace in Workspace Builder

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

* Release version: Yokohama
* 
* Updated January 30, 2025
* 
* ![](https://www.servicenow.com/docs/portal-asset/ico-clock) 2 minutes to read

Edit a workspace in Workspace Builder to make customizations in App Engine Studio (AES).
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://servicenow-prod.fluidtopics.net/N~ysuqZkMnCm4ol5thPOfg "Create a workspace in App Engine Studio (AES) to build a space that provides agents, case managers, help desk professionals, and managers with tools to help answer customer questions and resolve customer problems. Workspaces are primarily used for request and fulfillment processes, such as a service desk to manage tickets.").

Role required: sn_app_eng_studio.user or delegated_developer. For more information, see [Delegate developers using AES](https://servicenow-prod.fluidtopics.net/7nGx8ej0_uG1DIiyMPiwOA "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).").

## 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 AllApp EngineApp Engine Studio.
2. From the My Apps page, open your application.
3. Next to the workspace you created, select the additional actions icon (![Additional actions icon]()) and then select Edit.  
   You can also select the bar that lists the workspace in the Experience section of your app.{#configure-workspace-builder__wb-select-workspace-bar-edit}  
   Figure 1. Edit a workspace  
   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.
4. Edit the basic settings for the workspace by selecting Workspace settings.  
   For more information, see [Configure workspace settings in Workspace Builder](https://servicenow-prod.fluidtopics.net/1UTPxuD3j_NUCBOEIXSFhw "Define workspace settings in App Engine Studio (AES) to control the basic functionality of the workspace, such as name and record page navigation.").
5. Adjust the home page elements and widgets by resizing, reorganizing, or reconfiguring them.  
   For more information on editing a clickable home page, see [Configure a workspace home page in Workspace Builder](https://servicenow-prod.fluidtopics.net/aiU5OJU2THjL81gjTcA8Ew "Edit the home page for a workspace in App Engine Studio (AES). 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://servicenow-prod.fluidtopics.net/ZYDneu8Ka~yQVRKSVpU3Vw "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}
6. Add or edit a list category and any subsequent filtered lists.  
   For more information, see [Configure lists for a workspace in Workspace Builder](https://servicenow-prod.fluidtopics.net/5BY279bDp5mHG7QXaB7fUw "Create list categories in App Engine Studio (AES) to add pages that list table records. You can add filter conditions and change columns to create variations on the list.").
7. **Optional:** Enable an Analytics Center for the workspace.  
   For more information, see [Configure analytics for a workspace in Workspace Builder](https://servicenow-prod.fluidtopics.net/ufOBNHzjI8CF1qkTtQnCxA "Enable the Analytics Center for a workspace in App Engine Studio (AES). The Analytics Center enables users to track and analyze records and usage with dashboards, data visualizations, and insights on the instance.").
8. 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 [Configure a record page for a workspace in Workspace Builder](https://servicenow-prod.fluidtopics.net/XHq12umTtUzJmBDyZEtzEQ "Configure a record page for a workspace in App Engine Studio (AES). Use containers and components to guide a user through an experience. Each record page is linked to only one data table.").
9. 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.

*[\>]: and then