Component properties for the Object list

  • Release version: Australia
  • Updated March 12, 2026
  • 2 minutes to read
    • Summarize
    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 Component properties for the Object list

    The Object list component allows you to embed and customize a list of records from a ServiceNow table on a third-party website. The component properties enable detailed control over the data displayed, user interactions, and the component's appearance, ensuring it fits specific business needs and user experiences.

    Show full answer Show less

    Data Configuration

    • All Records vs. Top Records: Choose to display the full editable list with filtering and bulk actions or a prioritized, read-only list with a "view all" link.
    • Table & Query Settings: Select the table data to display and apply fixed query filters to refine results. Users can optionally edit default filters to further narrow the list.
    • Columns & Views: Define specific columns to show or use preconfigured UI views. Columns selection overrides list views when both are set.
    • Hierarchy and Grouping: Set a column to nest records hierarchically or group records by a column, with the option for users to change grouping.
    • Visibility: Optionally hide the component when no records are available.

    Header Configuration

    • Control the visibility of the header, including the title (custom or table name), subtitle, and record count badge.
    • Enable or disable the search bar (works only on indexed tables) and filter builder.
    • Manage user ability to select and arrange columns.
    • Show or hide action buttons, including global and table/view-specific actions, and add component-specific actions via an Action Config record.

    Columns and Rows Behavior

    • Columns: Enable clickable links in the first or reference columns to open record details. Control column highlighting based on UX Highlighted Value Configurations.
    • Rows: Allow or disable quick inline editing for users with permissions.

    Cell Display and Editing

    • Control text wrapping within cells to prevent overflow.
    • Set maximum characters displayed per cell before truncation.
    • Enable or disable inline cell editing for granular updates.

    Footer and Pagination

    • Configure how many records appear per page and how many page numbers are visible in pagination controls.
    • Limit the total records fetched to optimize performance and loading times.
    • Choose whether to display error messages to end users if the component fails to load.

    Practical Application for ServiceNow Customers

    These properties give ServiceNow customers the flexibility to tailor the Object list component to specific use cases, controlling what data is shown, how users interact with it, and how the list appears on external websites. Proper configuration enhances usability, performance, and integration with your ServiceNow data.

    Component property enables you to configure the behavior of the Object list component on a third-party website.

    Table 1. Object list properties - Data
    Component property Description
    Type All Records shows the complete list with options to edit, filter, and take bulk actions. Top Records shows a prioritized, read-only list with a view all link.
    Table Table data to display in the list.
    Edit query Query filters to refine the list results. These filters cannot be modified.
    Edit default filter Users can edit or remove this filter. When a query is set, it adds more conditions to narrow down the displayed records.
    Columns Select columns to be displayed. If both columns and List view are chosen, columns take priority.
    List view Uses preconfigured columns from the UI view table. If both columns and a list view are selected, columns take priority.
    Nest by Column used to define the hierarchy. If this property is not set, the list is displayed as a flat list.
    Default group by Group records by a specific column. User can choose to group by another column.
    Hide when empty Enable to hide the component when there are no records to show for the user.
    Table 2. Object list properties - Header
    Component property Description
    Hide header Option to show or hide the header.
    Title Displays the title of the list. You can set a custom title or use the table name as the default title.
    Subtitle Subtitle to display near the title. When empty, no subtitle will be displayed.
    Hide record count Option to show or hide the count badge on the header.
    Hide search Option to show or hide the search bar. Search works only for indexed tables.
    Hide filters Option to show or hide the filter with condition-builder.
    Disable column selection Option to disable or enable column selection and arrangement.
    Hide actions Option to show or hide the action buttons.
    Action config Global actions and actions set at the table or view level will automatically be displayed.

    To display additional actions specific to this component, select an Action Config record.
    Table 3. Object list properties - Columns
    Component property Description
    Disable clickable records When unchecked, values in the first column appear as clickable links to open record details.
    Enable clickable reference records When checked, values in the reference column appear as clickable links to open the related record details.
    Disable column highlighting When unchecked, column values are highlighted.
    Highlighted value config Select UX Highlighted Value Configuration record that defines which fields and values to highlight.
    Table 4. Object list properties - Rows
    Component property Description
    Disable quick edit When unchecked, users with required permissions can edit the records.
    Table 5. Object list properties - Cell
    Component property Description
    Disable cell wrapping When unchecked, automatically moves content to a new line within a cell when it exceeds the cell’s width. Long text may still be truncated.
    Max cell characters Displays number of characters in each cell before truncation.
    Disable cell editing Option to allow inline editing of cell.
    Table 6. Object list properties - Footer
    Component property Description
    Records per page Allows user to choose the number of records displayed on each page.
    Visible page range Sets how many page numbers are shown between navigation arrows.
    Limit records fetched Limit the total records fetched across all pages to improve component performance. Higher values may increase load times. Leave it empty to fetch all records.
    Hide errors Option to show or hide the error messages from end user when the component fails to load initially.