# StepContext.step_id
URL: https://lsd.tools/docs/api-context-step-id
Updated: 2026-07-17

## Example

```python
ctx.emit("viewer/status/set", step=ctx.step_id, text="done")
```

## Notes

Read-only, and `None` when no id is set. Use it only to **key** emitted events and logs — never to
read back project or engine state, which would produce outputs the resume-cache key cannot see.

## See also

**API:** [entity_id](/docs/api-context-entity-id) · [emit](/docs/api-context-emit) · [StepContext](/docs/api-context)

**Guides:** [Parameters vs ports](/docs/tools-params-ports)