| command | Comma-separated list of commands to run in order: release-pr, calculate-next, or release (e.g. "release,release-pr" runs release then release-pr) | no | release,release-pr |
| provider | Version control provider to use | no | github |
| token | GitHub token used to interact with the repository | no | ${{ github.token }} |
| repository | Repository in owner/repo format | no | ${{ github.repository }} |
| target-branch | Target branch for the release PR (defaults to the repository default branch) | no | ${{ github.event.repository.default_branch }} |
| current-branch | The branch that the workflow is currently running on. Used with release-branches to determine whether the action should run. | no | ${{ github.ref_name }} |
| release-branches | Comma-separated list of branch name glob patterns on which releases are permitted (e.g. "master,release/v*,**/release"). When set, the action only runs its commands if the current-branch matches at least one pattern. When unset or empty, the action runs on every branch. | no | ${{ github.event.repository.default_branch }} |
| pr-branch | Destination branch for the pull request. Defaults to target-branch. Use this for GitFlow-style setups where the analyzed branch and the PR destination differ. | no | — |
| prerelease | Calculate a prerelease version | no | — |
| prerelease-calculate-next | Calculate a prerelease version for the calculate-next command. Defaults to the value of the prerelease input when not set. | no | — |
| dry-run | Run without making any changes | no | — |
| debug | Enable detailed debug logging | no | — |
| versioner | Versioning strategy to use | no | — |
| version-prefix | Prefix for version tags (e.g. "v" produces "v1.2.3") | no | — |
| issue-url-template | URL template for issue/ticket references. Use {id} as the placeholder (e.g. "https://jira.example.com/browse/{id}"). Default sets to provider specific issue URL (e.g. GitHub issues) | no | — |
| type | Override the manifest type for every package | no | — |
| use-file-system | Use the local filesystem to scan and read files instead of provider APIs. Reduces API calls and can improve performance, but may not work in all environments (e.g. some CI setups). Requires code to be checked out. | no | true |
| include-chores | Include chore: commits in release eligibility and bump calculation | no | — |
| update-all-versions | Bump every manifest even when no changed files were found under that manifest path | no | — |
| write-local | (calculate-next only) Write updated version files to the local filesystem instead of committing them to the branch | no | false |