Configure list controls
You can configure list controls, such as buttons and filters.
Before you begin
Role required: personalize_control
Procedure
Open a list.
Right-click any column heading and select Configure > List Control.
Complete the form.
Note: The list control fields that are available for embedded lists are more limited. Unless otherwise noted, the list control fields in the following table are available for both standard and embedded lists.
| Field | Description |
|---|---|
| Table | Name of the table for the list or related list. For example, Change Request [change_request]. The system automatically sets this value. |
| Related list | Name of the table and field that define the related list. For example,sysapproval_approver.sysapproval. The system automatically sets this value. |
| Label | Label to display for this list. Allows an admin to customize the label for a related list or list. If not supplied, the default plural label for the file is used. For example, the label for the Incident table would be Incidents. |
| Omit new button | Option to prevent the New button from displaying on this list. Clear the check box to display the New button or to control the New button with roles (New roles field). This field is available for standard lists only. |
| Omit edit button | Option to prevent the Edit button from displaying on this list. Clear this check box to display the Edit button or to control the Edit button with roles (New roles field). The Edit button does not apply to all lists.This field is available for standard lists only. |
| Omit if empty | Option to omit the Related List from the form entirely (no header) if there are no entries for the Related List. |
| Omit columns if empty | Option for a top-level list to omit the column headers AND filters/breadcrumbs for an empty column. |
| Omit filters | Option to hide filters or breadcrumbs for this list. Clear this check box if you always want filters or breadcrumbs or to control filters/breadcrumbs with roles (Filter roles field). This field is available for standard lists only. |
| Omit links | Option to hide links for fields that reference other files in this list. Leave this button unchecked to generate links or to control the use of links with roles (Link roles field). |
| Omit drill-down link | Option to disable the link to the record from the first column in list view. Users can still select the reference icon to access the record. This field is available for standard lists only. |
| Omit related list count | Option to hide the related list count from displaying on initial load. Set it to False to restore it. |
| Hierarchical lists | See Enable a hierarchical list. Hierarchical list inserted into a record list. Hierarchical lists enable a user to view the contents of a record's related lists without leaving the record list form. This field is available for standard lists only. |
| List edit type | Ability for the user to edit values directly in individual cells in a list. The options are: - Save immediately (cell edit mode): enables cell editing. The entire row is saved when the user enters a new value. - Save data by rows: enables cell editing. The row is saved only when the user navigates away from the row or selects the Save icon ( Image omitted: IconSave.png - Disable list editing: prevents users from editing cells in the list. This field is available for standard lists only.Save icon). This mode allows the user to modify multiple values before saving a record. |
| List edit tag | Unique tag that is sent to a reference qualifier as the script variable *listEditRefQualTag*. Enter an arbitrary string of letters or numbers. |
| List edit insert row | Ability for a user to create records in list view. When it is enabled, an empty row appears at the bottom of the list. This field is available for standard lists only. |
| Remove pagination count | Option to remove pagination count from the list. |
| Disable Natural Language Query \(NLQ\) | Option to disable the NLQ filter in specific lists when NLQ on lists is enabled in the instance. The NLQ filter enables you to use natural language to filter lists instead of using the condition builder. For more information on NLQ filters, see Natural Language Query.Note: When the system property com.snc.listv2.nlq.lists.enabled(com.snc.listv2.nlq.lists.enabled) is set to false, the query destructs. Text entered in the search replaces existing conditions. |
| Application | Scope of this setting's applicability. Global means that all workspaces can use this setting. |
| New roles | User roles that can access the New button on this list. Leave the field blank to enable all users to access the New button. This option does not apply to embedded lists, which do not contain New buttons. |
| Filter roles | User roles required to have the filter appear in the list. This field is available for standard lists only. |
| Link roles | User roles required to have links generated for fields that reference other files. |
Parent Topic:Configuring lists on the ServiceNow AI Platform
Example of configuring list controls
The following example shows how to configure a list of related incidents in a problem record to suit specific business needs.
Before you begin
Role required: personalize_control
About this task
In this example, a related list label is configured to say Child Incidents, not just Incidents. The related list is also configured to remove the New button to prevent users from creating incidents from the Problem form.
Procedure
Navigate to a problem record.
Open the list context menu in the Incidents related list and select Configure > List Control.
On the List Control form, change the Label field to
Child Incidents.Select the Omit new button check box.
Select Submit to save your changes and return to the previous record, in this case, the problem record.
In the problem record, the label for the embedded incident list has changed and the New button is no longer available.