GitHub Actions workflow-level env not visible in run-name
run-name is evaluated very early, before jobs start, with access to a limited set of contexts (github, inputs). The env context is not available there, so an env reference in run-name resolves to nothing.
What this error means
The run-name shows up blank or with an unresolved expression because it references an env var.
github-actions
run-name: Deploy ${{ env.TARGET }} # env not available in run-name context
env:
TARGET: production
# run shows: "Deploy "Common causes
env context not available in run-name
run-name only supports github and inputs contexts; env is out of scope.
Workflow env defined after evaluation timing
run-name evaluates before job env is established.
How to fix it
Use github or inputs context in run-name
- Reference github.* or inputs.* values that are available at run-name evaluation.
- Pass dynamic values via workflow_dispatch inputs when needed.
.github/workflows/deploy.yml
run-name: Deploy ${{ inputs.target }} by ${{ github.actor }}Set the display value inside a job instead
- If the value is only known at runtime, surface it in the job summary rather than run-name.
- Write to the step summary for a readable label.
How to prevent it
- Limit run-name expressions to github and inputs contexts.
- Use job step summaries for runtime-derived labels.
Related guides
GitHub Actions format() placeholder index out of rangeFix a format() expression that references a {N} placeholder with no matching argument supplied.
GitHub Actions env at Workflow vs Job vs Step - Wrong Value WinsFix GitHub Actions env variable scoping - workflow, job, and step env blocks override each other, and step-le…
GitHub Actions secret-derived env var cannot be used in run-nameFix a run-name that cannot include a secret-derived value because both env and secrets contexts are unavailab…