---
sourceDocument: Australia Build or modify applications
sourceDocumentLink: https://servicenow-prod.fluidtopics.net/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


---

# Configurable workspace components examples

# Configurable workspace components examples {#ariaid-title1}

Release version: Australia  
Updated March 12, 2026  
![](https://www.servicenow.com/docs/portal-asset/ico-clock) 2 minutes to read
Summarize  
![AI sparkle icon](https://servicenow.com/docs/portal-asset/ai-sparkle-icon) Summarized using AI  
This content was generated using new OpenAI-powered functionality. Results are provided on an as is basis and are not guaranteed to be accurate or complete.  

## Summary of Configurable Workspace Components Examples

This document provides practical examples for interacting with configurable workspace components in ServiceNow, which allow users to perform various actions on UI elements effectively.
Each component has specific actions that can be executed to enhance user experience and facilitate interaction within the workspace.
Show full answer Show less  

## Key Features

* **sn-canvas-toolbar:**
  * Assert button exists by group and tool tip
  * Assert button selected by group and tool tip
  * Select button by group and order
  * Select button by group and tool tip

  For this component, specify the group ('top' or 'bottom'), the toolTip (exact tab name), and the order number (starting at 1) to interact with the toolbar tabs.
* **now-uxf-tab-set:**
  * Assert tab selected by label
  * Select tab by order
  * Select tab by label

  Actions require the exact tab name for assertions and selections. The order number specifies which tab to open.
* **now-record-list-connected:**
  * Apply filter on the list
  * Click a list UI action button
  * Validate record visibility in the list
  * Validate the visibility of list's declarative actions
  * Open a record in the list

  Users can select UI actions, validate record visibility, and open records from the list, with all relevant records displayed for easier interaction.

## Key Outcomes

By utilizing these components effectively, ServiceNow customers can enhance their workspace interactions, ensuring that they can quickly access and validate necessary elements, leading to improved productivity and user satisfaction.  
To grasp how to interact with configurable workspace components, review these examples.  
Note:  
When you submit an action in a component, a test step is created.  

## sn-canvas-toolbar {#atf-conf-ws-comp-examples__example_w35_f3d_cgc}

For sn-canvas-toolbar component, it has the following four actions:

* Assert button exists by group and tool tip
* Assert button selected by group and tool tip
* Select button by group and order
* Select button by group and tool tip
{#atf-conf-ws-comp-examples__ul_afg_k3d_cgc}  
These are the expected values for the actions:

* group: Enter either 'top' or 'bottom' depending on which tab in the toolbar you want to interact with.
* toolTip: Name of the tab in the toolbar you want to open.

  Note:  
  An error is shown if the toolTip name doesn't exactly matches the tab name you want to open up.
* order: Depending on the group entry, the order number is decided. The order starts at 1. For instance, if you've selected 'top' for a group in a toolbar with six items and want to access the second tab from the top, you'd enter '2' as the order number. Similarly you'd enter '5' as the order number if you've selected 'bottom' for a group.

{#atf-conf-ws-comp-examples__ul_dth_hjd_cgc}  
Note:  
When you submit an action to select a specific tab (based on its group and order), that tab becomes focused or highlighted. When you enter the exact name of the tab in the toolTip, that tab opens up.  

## now-uxf-tab-set {#atf-conf-ws-comp-examples__example_dw5_1sd_cgc}

For now-uxf-tab-set component, it has the following three actions:

* Assert tab selected by label
* Select tab by order
* Select tab by label
{#atf-conf-ws-comp-examples__ul_nsq_ctd_cgc}  
These are the expected values for the actions:

* label: Enter the exact name of the tab that you want to assert if it exists. For example, after selecting the Assert tab selected by label action, enter 'Hardware assets' to check if the 'Hardware assets' tab is present. The expected return value is True if it exists. If you select Select tab by label action, enter the name of the tab in the toolbar you want to open.
  * Assert tab selected by label

  * Select tab by label

  {#atf-conf-ws-comp-examples__ul_byn_3yd_cgc}
* order: The order number you enter determines which tab opens on the selected toolbar.

{#atf-conf-ws-comp-examples__ul_dpy_htd_cgc}  

## now-record-list-connected {#atf-conf-ws-comp-examples__example_mmt_s12_cgc}

For now-record-list-connected component, it has the following five actions:

* Apply filter on the list
* Click a list UI action button
* Validate record visibility in the list
* Validate the visibility of list's declarative actions
* Open a record in the list
{#atf-conf-ws-comp-examples__ul_dl4_3c2_cgc}  
These are the expected values for the actions:

* Select the required UI action.  
  Note:  
  Only the UI actions which are available in the list shows up.

* Select the record from the list you want to validate.  
  Note:  
  All the records in the list show up when you select the Validate record visibility in the list action.

* Select the required UI action to validate its visibility in the list.

* Select the required record to open from the list.  
  Note:  
  All the records in the list show up when you select the Open a record in the list action.

{#atf-conf-ws-comp-examples__ul_zxr_nc2_cgc}