github GitHub Changelog ·

GitHub Actions: Reference same-repo workflows with self-repository syntax

infraengineer
feature

GitHub Actions now supports a new self-repository syntax (`$/`) to reference actions and reusable workflows within the same repository. This eliminates the need for checking out code or hardcoding versions, ensuring internal references remain consistent with the running commit SHA. This feature is available on github.com for runners version 2.336.0 and newer, simplifying maintenance and enabling adherence to enterprise policies requiring pinned action SHAs.

  • Reference same-repository actions with self-repository syntax
  • Simplify internal action and workflow composition
  • Availability and prerequisites for self-repository syntax
Features (1)
  • Reference same-repository actions with self-repository syntax

    A new `$/` syntax allows referencing actions and reusable workflows within the same repository without requiring a checkout. This ensures internal references automatically match the running commit SHA, even when callers pin to a specific commit.

Enhancements (1)
  • Simplify internal action and workflow composition

    This feature removes the maintenance burden of hardcoding versions or relying on `./` syntax with checkout, which previously defeated commit SHA pinning. It makes it easier to adopt enterprise policies requiring actions to be pinned to a full-length commit SHA.

Notes (1)
  • Availability and prerequisites for self-repository syntax

    Self-repository references are now the recommended way to compose actions and reusable workflows within a repository and are available on github.com. This feature requires the GitHub Actions runner to be on version 2.336.0 or newer.

Read the original announcement →

https://github.blog/changelog/2026-07-30-reference-same-repository-actions-with-self-repository-syntax

Related releases