Use the GetListItem component

task australia Updated Sep 10, 2026 1 min read use-reflection-getlistitem.md

Return items from a list by using the GetListItem component in RPA Desktop Design Studio.

Before you begin

Role required: none

About this task

You can configure the properties for the GetListItem component. For more information about these properties, see Properties of the Reflection components.

Procedure

In the Toolbox pane, navigate to Utilities > Reflection.
Drag the GetListItem component to the Design surface.
To set the field that accepts an item from the list, do the following steps.
1. Click the component settings icon ([Omitted image "component-settings-icon.png"] Alt text: Component settings icon.).
2. Click the add index icon ([Omitted image "add-image-icon.png"] Alt text: Add index icon.).
3. Update the data type of the index value.
  
  A Data out port is dynamically created with each index that you add.
4. Repeat the steps to add more indexes.
5. Click OK.
To configure the input field, Configure port properties.

Connect the data and control ports of the GetListItem component to the corresponding ports of the other components.

Port type	Port name	Data type	Purpose of connection	Default value	Mandatory?
Data In	Instance	Object	Takes a list item.	No default value	Yes
Data Out	Name of the port is the same as the name of the index value that is created.	Object	Returns the list item.	Not applicable	Not applicable

To test the component, right-click the component bar and then click Run From Here.

Parent Topic:Reflection

59 lines · 2.6 KB Wrap lines

---
title: Use the GetListItem component
description: Return items from a list by using the GetListItem component in RPA Desktop Design Studio.
locale: en-US
canonical_url: https://www.servicenow.com/docs/r/australia/integrate-applications/use-reflection-getlistitem.html
release: australia
topic_type: task
last_updated: "2026-09-10"
reading_time_minutes: 1
breadcrumb: [Reflection, Utilities, Automation components, RPA Desktop Design Studio, Robotic Process Automation \(RPA\) Hub, Workflow Data Fabric]
---

# Use the GetListItem component

Return items from a list by using the GetListItem component in RPA Desktop Design Studio.

## Before you begin

Role required: none

## About this task

You can configure the properties for the GetListItem component. For more information about these properties, see [Properties of the Reflection components](https://raw.githubusercontent.com/ServiceNow/ServiceNowDocs/australia/markdown/australia/integrate-applications/util-reflection-prop.md).

## Procedure

1.  In the Toolbox pane, navigate to **Utilities** &gt; **Reflection**.

2.  Drag the GetListItem component to the Design surface.

3.  To set the field that accepts an item from the list, do the following steps.

    1.  Click the component settings icon \(\[Omitted image "component-settings-icon.png"\] Alt text: Component settings icon.\).

    2.  Click the add index icon \(\[Omitted image "add-image-icon.png"\] Alt text: Add index icon.\).

    3.  Update the data type of the index value.

        A Data out port is dynamically created with each index that you add.

    4.  Repeat the steps to add more indexes.

    5.  Click **OK**.

4.  To configure the input field, [Configure port properties](https://raw.githubusercontent.com/ServiceNow/ServiceNowDocs/australia/markdown/australia/integrate-applications/configure-input-port-properties.md).

5.  Connect the data and control ports of the GetListItem component to the corresponding ports of the other components.

    |Port type|Port name|Data type|Purpose of connection|Default value|Mandatory?|
    |---------|---------|---------|---------------------|-------------|----------|
    |Data In|Instance|Object|Takes a list item.|No default value|Yes|
    |Data Out|Name of the port is the same as the name of the index value that is created.|Object|Returns the list item.|Not applicable|Not applicable|

6.  To test the component, right-click the component bar and then click **Run From Here**.


**Parent Topic:**[Reflection](https://raw.githubusercontent.com/ServiceNow/ServiceNowDocs/australia/markdown/australia/integrate-applications/reflection-utility.md)