---
sourceDocument: Brazil Sales Customer Relationship Management
sourceDocumentLink: https://servicenow-prod.fluidtopics.net/r/order-management

 Release :

    - brazil

ft:locale :

    - en-US

ft:publication_title :

    - Brazil Sales Customer Relationship Management

ft:clusterId :

    - omgmt

bundleId :

    - omgmt

workflow :

    - Customer and Industry


---

# Using sets in layouts

# Using sets in layouts {#ariaid-title1}

Release version: Brazil  
Updated March 12, 2026  
![](https://www.servicenow.com/docs/portal-asset/ico-clock) 4 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 Using sets in layouts

This guide explains how sets can be displayed and configured within layouts in ServiceNow, enabling administrators to control the presentation and interaction of set data effectively.
Sets can be arranged in multiple display formats and customized through various settings to enhance user experience and data management.
Show full answer Show less  

## Display Types and Configuration

* **Display Formats:** Sets can appear as table rows (horizontal display), table columns (vertical display), list rows (tiles), or as set repeaters where each index corresponds to a tier. Set repeaters have a separate administration process.
* **Layout Wizard Settings:** Administrators manage display types via the Layout Wizard by selecting a set and using the gear icon to choose between 'Table' (grid) and 'List' (tiles) display types.

## General Settings

* **Expand Direction:** Choose whether indexes expand downwards as rows or horizontally as columns.
* **Maximum Height:** Define the set's height limit.
* **Show Index and Index Label Template:** Control visibility of index numbers and add contextual prefixes or suffixes (Table display only).
* **Vertical Alignment:** Adjust alignment for list display types.

## Message Settings

* **Message Summary:** Option to show a summarized message display for actions and recommendations, positioned above or below the set.
* **Message Indicators:** For table display, color-coded triangles indicate cells with messages, with hover tooltips to show details.

## Size Settings

* Applicable for sets with a field-based size type (not associate picklists).
* Control the number of indexes displayed, visibility of size field and increment button, and input methods (number field or slider).
* Placement of the size input field is configurable, including options to submit changes immediately or require confirmation (Table display only).

## Inline Control Settings

* Configure inline index menu options such as showing add buttons before or after an index and toggling dropdown controls (caret icon) for size adjustments.

## Selection Settings (List Display Only)

* Enable or disable selection controls with options for single (radio buttons) or multiple (checkboxes) selections.
* Specify a boolean field within the set to manage selection states, which can be visible in the set layout.

## Search Settings (List Display Only)

* Define source and target fields to enable search functionality within the set based on user input.

## Aggregates

* Sets support five aggregate types: Average, Count, Max, Min, and Sum, applicable to any field type.
* Aggregates summarize data across all indexes and can be displayed like other fields by configuring them in the Layout Wizard.
* Aggregate variables follow the naming convention: `set.{set variable name}.{aggregate variable name}`.

## Additional Information

* All set settings are editable within the layout's CSV file value column or by updating JSON directly, provided the data structure is maintained.
* For advanced use cases, refer to related materials on how sets integrate with blueprints and creating set repeaters.  
Learn about the various ways sets can be displayed and about their settings.

## Display types {#layouts-sets__section_kfd_mvq_chc}

Sets can be displayed in several ways:

* As table rows where each index is displayed horizontally:

* As table columns where each index is displayed vertically:

* As list rows:

* As a set repeater where each index is tied to a tier:

  Set repeaters are distinct in their administration. For more information about set repeaters, see [Creating a Set Repeater](https://logikio.atlassian.net/wiki/spaces/CS/pages/1614446937/Creating+a+Set+Repeater).
{#layouts-sets__ul_z5k_vvq_chc}

To manage the different display types, find the set in the Layout Wizard and select the gear icon. Here the admin has two options for Display Type: Table and List. Table is a basic grid, while List is a series of tiles.


## General settings {#layouts-sets__section_hr5_mvq_chc}

* Expand Direction: Allows the user to specify how the set is formatted.
  * Rows: Each index is displayed as a row. As the set size increases, it will expand down the page.
  * Columns: Each index is displayed as a column As the set size increases, it will expand horizontally to the right.
  {#layouts-sets__ul_epg_yxq_chc}
* Maximum Height: The height of the set.
* Show Index (Table Display Type only): Whether the index is displayed in the set.

* Index Label Template (Table Display Type Only): display a prefix or suffix string to the index numbers. Helps provide context of each index.![layout]()

* Vertical Alignment (List Display Type Only): Control the alignment.
  * Middle

  * Top

  {#layouts-sets__ul_y4b_3yq_chc}
{#layouts-sets__ul_kvp_sxq_chc}

## Message settings {#layouts-sets__section_hmv_nvq_chc}

These options allow the admin to control how and where messages are displayed.

* Show message summary: summarizes all message actions and recommendation messages in one position. Toggling this to true will show the summary. Toggling to false, removes the summary.
* Message summary position: display the message summary above or below the set. The following image shows Show Message Summary = true and Message Summary Position = Top.


* Show message indicator inside cell (table display type only): places a color-coded triangle in the cell that caused the message.
* Show message when hovering indicator (table display type only): displays messages when users hover over the color-coded triangle.

{#layouts-sets__ul_p2t_vyq_chc}

## Size settings {#layouts-sets__section_sss_4vq_chc}

The size of the set refers to the number of indexes that will be displayed. This is applicable to sets with the size type of field, not for associate picklist sets. A size of 1 means that there is 1 index. A size of 10 means that
there are 10 indexes.

* Show size field: shows or hides the size field.

* Show Increment Size Button: control whether the green + icon is visible.

* Size Field Display Type: Pick between a number field or a slider field for user input.

* Placement of Size Field: Control the location of the size field relative to the set itself.
* Submit Size Changes on Field Input (Table Display Type Only): When true, the set adjusts according to any keystroke change in the size input field.
* Display a Confirmation Before Submitting Size Changes (Table Display Type Only): This property displays the confirmation button when set true. False hides the confirmation button.
{#layouts-sets__ul_rjh_ybr_chc}

## Inline control settings {#layouts-sets__section_rwf_pvq_chc}

These settings refer to options in the index column menus.


* Show Add Button Before an Index: showAddBefore: show/hide the Add Row Above control.
* Show Add Button After an Index: showAddAfter: show/hide the Add Row Below control.
* Show Dropdown Controls: show or hide the inline size control menu.

  The dropdown controls setting refers to the caret icon on the index. It is not to be confused with the green bar for inserting indexes. Add Row Above and Add Row Below refer to the other controls here.
{#layouts-sets__ul_zx1_kcr_chc}

## Selection settings {#layouts-sets__section_eps_pvq_chc}

Selection settings apply only to the list display type. These controls affect how the user interacts with a set that is displayed as a list.


* Show Selector: toggles selectors on and off.
* Selection Type: choose between Single or Multiple. Single will appear as radio buttons and Multiple will appear as check boxes.Example of single selection where Show Selector is true:


  Example of multiple selection where Show Selector = false:


* Boolean field for selection: specify a field in the set that will be marked as true. This is required for the selection to work. If desired, the value can be displayed in the set itself:

{#layouts-sets__ul_vqf_rcr_chc}  
Note:  
All of the set settings are editable in the value column of the layout CSV file. Admins are still able to update the JSON there and make changes. If this method is chosen, the entire list of properties does not need to be included, but be sure to keep the proper data structure intact.

## Search settings {#layouts-sets__section_fq1_ddr_chc}

Search settings apply only to the list display type.


## Search settings (List display type only) {#layouts-sets__section_kvq_xbr_qhc}

* Source Field: The global field that, when the user changes, triggers the UI to search based on the value of the field.
* Target Field: The set subfield that has its value compared to the source fieldʼs value to determine whether it is a match.
{#layouts-sets__ul_gzk_fdr_chc}

## Displaying aggregates {#layouts-sets__section_bxd_qvq_chc}

Aggregates are a way to evaluate the data in a set. Set aggregates have five types and can aggregate on any field type. The types are:

* Average
* Count
* Max
* Min
* Sum

{#layouts-sets__ul_uzg_kdr_chc}

For example, a sum aggregate on a number field will add all the instances of that subfield across all indexes. The admin can display that aggregate just as with any other field in the layout by specifying the field in the Layout
Wizard.

The variable name for aggregates have the following syntax: `set.{set variable name}.{aggregate variable name}`
**Related concepts**   

* [How sets interact with the rest of a blueprint](https://servicenow-prod.fluidtopics.net/xjh4bnAHM6rpcRdAq3xasw "The implications of sets when used in blueprints.")
* [Creating set aggregates](https://servicenow-prod.fluidtopics.net/9ehjK~dbVAZZEJn5Gc8h2Q "You can collect the average, count, maximum, minimum, and sum of the data in any field in a set by using a set aggregate.")

