---
sourceDocument: Yokohama Build or modify applications
sourceDocumentLink: https://www.servicenow.com/docs/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


---

# List API

# List API - ServiceNow Fluent {#ariaid-title1}

* Release version: Yokohama
* 
* Updated March 12, 2026
* 
* ![](https://www.servicenow.com/docs/portal-asset/ico-clock) 1 minute to read

The List API defines list views \[sys_ui_list\] for tables.
Note:  
For the latest ServiceNow Fluent API documentation and examples, see the [ServiceNow Fluent API reference](https://servicenow.github.io/sdk/) and [ServiceNow SDK examples repository](https://github.com/ServiceNow/sdk-examples) on GitHub.

For general information about lists, see [ServiceNow AI Platform® list administration](https://www.servicenow.com/docs/access?context=p_ListAdministration&version=yokohama&pubname=yokohama-platform-administration&ft:locale=en-US).
**Related concepts**   

* [ServiceNow Fluent](https://www.servicenow.com/docs/~uRaWXiuRJuyUsvJypBknQ "Define application metadata in source code using the ServiceNow Fluent domain-specific programming language.")

## List object {#ariaid-title2}

Configure lists \[sys_ui_list\] and their views.
{#list-object-now-ts__table_vy2_525_jq__entry__3}

| Name | Type | Description |
|-|-|-|
| table | String | Required. The name of the table to which the list applies. |
| view | Reference or String | Required. The variable identifier or name of the UI view \[sys_ui_view\] which applies, or the default view. To define a UI view, use the [Record API - ServiceNow Fluent](https://www.servicenow.com/docs/TPuAIpTcWh9Xd1b7Via69w#record-api-now-ts "The Record API defines records in any table. Use the Record API to define application metadata that doesn't have a dedicated ServiceNow Fluent API."). To use the default view (`default_view`), you must import it: import { default_view } from '@servicenow/sdk/core' |
| columns | Array | Required. A list of columns in the table to display in the list, specified using the column name and position in the list. |
| $meta | Object | Metadata for the application metadata. With the installMethod property, you can map the application metadata to an output directory that loads only in specific circumstances. $meta: { installMethod: 'String' } Valid values for installMethod: * demo: Outputs the application metadata to the metadata/unload.demo directory to be installed with the application when the Load demo data option is selected. * first install: Outputs the application metadata to the metadata/unload directory to be installed only the first time an application is installed on an instance. {#list-object-now-ts__ul_n3q_y3s_42c} |
[Table 1. Properties]

{#list-object-now-ts__table_vy2_525_jq}  

    import { List } from "@servicenow/sdk/core";

    List({
        $id: Now.ID["app_task_view_list"],
        table: "cmdb_ci_server",
        view: app_task_view,
        columns: [
            { element: "name", position: 0 },
            { element: "business_unit", position: 1 },
            { element: "vendor", position: 2 },
            { element: "cpu_type", position: 3 },
        ],
    });

The UI view definition referenced is defined using the Record object:

    import { Record } from "@servicenow/sdk/core";

    const app_task_view = Record({
       $id: Now.ID['app_task_view'],
       table: 'sys_ui_view',
       data: {
            name: 'app_task_view',
            title: 'app_task_view'
       }
    })