---
alias: user-guide-business-workflow-task-load-sub-materials
render_macros: false
description: "Loads matching persisted sub-materials below one material."
---

# Load Sub-Materials

Loads matching persisted sub-**Materials** below one **Material**.

![Screenshot of a Business Workflow loading descendants of a parent Material.](images/business-workflow-task-load-sub-materials.png)

## Inputs

Set `Material`, `LevelsToLoad` in the task details. Use the value editor to select compatible results from earlier tasks.

### Named Input Rows

Use the **+** button in **Inputs** to add one row per property filter. Enter its exact name, select its type, and enter a value or select an earlier result. Keep the fixed inputs. Additional names must be unique and different from the fixed input names.

See [Named Input Rows](../../../business_workflow_task.md#named-input-rows) for a worked example.

## Outputs

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

??? example "Load Sub-Materials"

    Connect a parent **Material** and set `LevelsToLoad` to 2. Add a String row named `Type` with the desired **Material** type. `Result` contains matching descendants; `Records` also includes predecessor and depth.

## Behavior

Set `LevelsToLoad` to 0 for no results, 1 for direct neighbors, or -1 for every reachable level. The starting entity is excluded. Named property filters are combined with AND. Traversal continues through nonmatching intermediate entities. Results preserve traversal order, and `Records` includes predecessor and depth.