---
alias: user-guide-business-workflow-task-change-entity-state
render_macros: false
description: "Applies one configured state-model transition to an entity instance or version."
---

# Change Entity State

Applies one configured state-model transition to an entity instance or version.

![Screenshot of a Business Workflow applying the Accept transition to a Material through its state model.](images/business-workflow-task-change-entity-state.png)

## Inputs

Set `Entity`, `StateModel`, `TransitionName`, `Reason`, `Comment` in the task details. Use the value editor to select compatible results from earlier tasks.

## Outputs

Use `Entity`, `State` in subsequent tasks.

??? example "Change Entity State"

    Connect the entity, select the assigned `StateModel`, and enter its configured `TransitionName` and optional `Reason`. Use the returned `Entity` and `State`. This Core task supports native entity instances and versions; native transition rules still apply.

## Behavior

This Core task accepts entity instances and entity versions. The state model must be assigned to the entity, and the configured transition rules apply.