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


---

# Add a workspace

# Add a workspace {#ariaid-title1}

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


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.
This video shows you how to perform the following procedure.

<br />

## Before you begin

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

When you add a workspace you're creating a basic version of it, which you must then continue editing in Workspace Builder before it's ready to deploy. For more complex customizations, edit the workspace in UI Builder.

If you create a workspace from an App Engine Studio workspace experience template, you can edit the home page, lists, and record pages in Workspace Builder. However, if you create the workspace using an application template, you must edit some of its pages and objects in UI Builder.

## Procedure

1. Navigate to AllApp EngineApp Engine Studio.
2. From the My Apps page, open your application.
3. In your application, next to Experience, select Add.
4. Select Workspace, and then select Begin.
5. On the form, fill in the fields.  
   {#add-workspace__table_wrp_z3h_14b__entry__2}

   | Field | Description |
   |-|-|
   | Name | Name of the workspace that appears to users. By default, the workspace shares the same name as your application. Tip: Use a name that uniquely identifies the workspace from other experiences. For example, <kbd class="ph userinput">Office art requests workspace</kbd>. |
   | Description | Description of the workspace. |
   | URL | Unique web address of the workspace. By default, the workspace URL is based on the application name, but you can edit it. |
   | Roles | User roles to limit who can access the workspace. * You must specify at least one role to grant access to the workspace. * To use a custom role for your workspace, you must create one in Security first. {#add-workspace__ul_fdv_tpy_5tb} For more information, see [Add application security](https://servicenow-prod.fluidtopics.net/lGBiWQYGFF~Ys_U2gG0NFw "Control who is permitted to use or edit your application by configuring roles in App Engine Studio (AES)."). |
   [ ]

   {#add-workspace__table_wrp_z3h_14b}
6. Select Continue to define data for your workspace.
7. On the form, fill in the fields.  
   {#add-workspace__table_utl_qjh_14b__entry__2}

   | Field | Description |
   |-|-|
   | Primary Table | Data table that workspace users view or update. |
   | Secondary Tables | Additional data tables that workspace users view and update. |
   [ ]

   {#add-workspace__table_utl_qjh_14b}  
   Note:  
   You can select only tables with default views. You can select from two sections: Tables that are already available in your app, and all tables outside the app scope.  
   Workspace Builder automatically generates a record page for the table you select.
8. Select Continue, and then select Done.  
   After you create the workspace in AES, you must edit it in Workspace Builder by adding or configuring components on each page.
9. 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.{#add-workspace__wb-select-workspace-bar-edit}  
   Figure 1. Edit a workspace {#add-workspace__edit-workspace-wb-cmd}
10. **Optional:** Edit your workspace home page in the In-line editor by selecting Preview.
    1. On your workspace home page, select Edit.  
       If you don't see Edit, you may not have the permissions needed to edit the workspace home page.
    2. If the workspace is missing an Access Control List (ACL), enter the roles that should have access in the Add user roles to continue modal and select the Add roles button.  
       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.") and [Access Control List Rules](https://www.servicenow.com/docs/access?context=access-control-rules&version=yokohama&pubname=yokohama-platform-security&ft:locale=en-US).
    3. Adjust the home page elements and widgets by resizing, reorganizing, or reconfiguring them.  
       Editing your workspace home page works similarly to editing a dashboard on your workspace. For more information, see [Edit Platform Analytics dashboards](https://www.servicenow.com/docs/access?context=edit-db-in-ac&version=yokohama&pubname=yokohama-now-intelligence&ft:locale=en-US).  
       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.

       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.
       {#add-workspace__adjust-workspace-inline}
    4. Select Add new element to add items to your workspace home page. {#add-workspace__wb-add-new-element}
    5. Select Exit Editing Mode to stop editing in the In-line editor. {#add-workspace__wb-exit-editing-preview}
11. Edit the workspace in Workspace Builder. For more information, see [Configure a workspace in Workspace Builder](https://servicenow-prod.fluidtopics.net/UWMRVbooyRy4OLmx233ikg "Edit a workspace in Workspace Builder to make customizations in App Engine Studio (AES).").  
    You can also add more record pages to the workspace, if needed.  
    Note:  
    The default workspace record pages are read-only and can't be edited. To change the content of each record page, create a page variant and edit the variant.
* **[Sample workspaces you can build](https://servicenow-prod.fluidtopics.net/_RT34a3k4RXiXQbip1JpKw)**   
  App Engine Studio (AES) provides a basic workspace that includes a home page, record pages, lists, an Analytics Center, and other functions.
* **[Building workspaces in AES](https://servicenow-prod.fluidtopics.net/5ai2pN_HZfUKnuQrsPdT9w)**   
  Workspace Builder for App Engine is a streamlined, no-code environment that enables you to create a custom workspace from within App Engine Studio (AES) quickly and efficiently.
* **[Configure a workspace in Workspace Builder](https://servicenow-prod.fluidtopics.net/UWMRVbooyRy4OLmx233ikg)**   
  Edit a workspace in Workspace Builder to make customizations in App Engine Studio (AES).
* **[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.
* **[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.
* **[Workspace Builder components for home pages](https://servicenow-prod.fluidtopics.net/iuVFbPKEkutbJng8fizoPQ)**   
  Several UI Builder components are available as elements to build home pages and contextual side panels in Workspace Builder. Workspace Builder helps you quickly create workspaces in App Engine Studio (AES).
* **[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.
* **[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.
* **[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.

*[\>]: and then