# Query entity records

> Query entity records node for reading one or more records from a Data Fabric entity in a Flow, without an Integration Service connection.

Reads one or more records from a Data Fabric entity. This is a native Flow node — it doesn't require an Integration Service (IS) connection. It works only with entities created inside a VS Code solution. Refer to [Entities in VS Code](entities-in-vs-code.md).

![Query entity records node's Properties panel, set to return multiple records, showing a Data Fabric entity picker, an AND/OR filter condition builder with nested groups, and Additional properties for sort, skip, and record limit.](https://dev-assets.cms.uipath.com/assets/images/maestro/node-query-entity-records-properties-0cce78e8.webp)

## Configuration

| Field | Required | Description |
|---|---|---|
| **Data Fabric entity** | Yes | The entity to query. Select **Refresh schema** if the entity's fields changed since you added the node. |
| **Records to return** | Yes | **Single record** returns one record and fails if the filter matches more than one. **Multiple records** returns an array of matching records. |
| **Filter condition(s)** | No | One or more field/operator/value conditions, combined with **All (AND)** or **Any (OR)**. |
| **Sort by** (Multiple records only) | No | The field to sort results by, and direction (**Ascending** or **Descending**). Without a sort, the query can return a different set of records each time. |
| **Records to skip** (Multiple records only) | No | Number of matching records to skip before returning results. Default `0`. |
| **Record limit** (Multiple records only) | No | Maximum number of records to return. Default `100`, maximum `1000`. |

Within **Filter condition(s)**, select **Add condition** for another condition at the same level, or **Add group** to nest a condition group with its own AND/OR logic.

This node doesn't support the **Error handling** tab.

## Output

For **Single record**, the output fields mirror the entity's schema directly. For **Multiple records**, the output is a `results` array, with each item mirroring the entity's schema. Access them downstream as `$vars.<nodeId>.output.<fieldName>` (single record) or `$vars.<nodeId>.output.results[<index>].<fieldName>` (multiple records).

The output panel includes a **Live** mode. When it is enabled, the output is a live reference to the query, tagged **Live query** in the schema tree — downstream nodes always see current values without re-running the query. [Update entity record](node-update-entity-record.md) and [Delete entity record](node-delete-entity-record.md) can target a record found by this node directly, by referencing it instead of re-specifying the entity and filter.
