> For the complete documentation index, see [llms.txt](https://community-test.logicnets.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://community-test.logicnets.com/release-9/platform-documentation/process-node-parts/get-item-from-collection.md).

# Get Item from Collection

## Description

The Get Data Item part retrieves a specific item value from a collection. It is shown in the Designer Part Editor menu as *Get item in collection.*

## Use

This part can be used to retrieve values within a similar set. Often, this part is used within a loop that cycles through all items one at a time, where each item has to be processed by similar logic or decision trees.

## Tips and Tricks

Note it is not possible to retrieve a specific value from a collection using this part. Instead the logic process would be

* create a rule to check if a specific value exists and continue process from there
* or loop through the values until a rule checking for the value becomes true (if collection is small)

To find exact position use query collection with a condition, get the path to the result and extract the item number using text pattern matching.

## Editor Fields

| Field Name  | Description/Use                                                                                                                                                                                                                                                                                                                                                                                                                                           | Type/Options                 | Optional/Mandatory |
| ----------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ---------------------------- | ------------------ |
| Data object | This is the data object that will be assigned the value retrieved from the specific position in the collection.                                                                                                                                                                                                                                                                                                                                           | Data Object                  | Mandatory          |
| Group       | <p>With this option you can create a top-class and assign the Data object's parent and call the date object via the parent.<br>Data object: <strong>my\_date\_object</strong><br>Group: <strong>my\_group</strong><br>To use: <strong>my\_group.my\_date\_object</strong><br>"Group" is meant to be a container of data objects. If the "Group" field is empty then <em>my\_date\_object</em> should be called directly without any parent extension.</p> | Text                         | Optional           |
| Collection  | This is the collection containing the items for inspection.                                                                                                                                                                                                                                                                                                                                                                                               | Data Object                  | Mandatory          |
| Position    | This is the position number of the value to be changed.                                                                                                                                                                                                                                                                                                                                                                                                   | <p>Number<br>Data Object</p> | Mandatory          |

## Example

Download and import the following [example project](/release-9/example-gallery/example-projects-for-parts/get-item-from-collection-example-project.md) in your workspace.


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation by asking a question.

Perform an HTTP GET request on the following URL with the `ask` and `goal` query parameters:

```
GET https://community-test.logicnets.com/release-9/platform-documentation/process-node-parts/get-item-from-collection.md?ask=<question>&goal=<user_goal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is what the user is ultimately trying to achieve, the reason they need the answer. Sharing it helps GitBook give you a better, more relevant answer. A goal is most helpful when it describes the outcome the user wants rather than restating the question. For example, with `ask=how do I create an API token`, a goal like `automate deployments from our CI pipeline` lets GitBook tailor the answer to that use case.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.