---
alias: user-guide-business-workflow-task-load-entities
render_macros: false
description: "Loads entity identifiers or names and optionally refreshes existing references, without creating or persisting entities."
---

# Load or Refresh Entities

Loads entity identifiers or names and optionally refreshes existing references, without creating or persisting entities.

![Screenshot of a Business Workflow loading Materials from supplied entity identifiers.](images/business-workflow-task-load-entities.png)

## Inputs

Set `EntityType`, `Entities`, `Revision`, `Version` in the task details. Use the value editor to select compatible results from earlier tasks.

## Settings

Configure `RefreshExisting`, `MissingEntityBehavior` in the task settings.

## Outputs

Use `Result`, `Found` in subsequent tasks.

??? example "Load or Refresh Entities"

    Select **Material** as `EntityType`, connect **Material** identifiers from an earlier query to `Entities`, and use `Result` in For each. Choose the missing-entity behavior explicitly.

## Behavior

Names are treated as names, including names containing only digits. Select **Refresh existing references** to reload an existing reference. In **ReturnNotFound** mode, missing entities are omitted and `Found` is false.