| github_token | GitHub Access Token
contents:write - Push commits
| no | — |
| default_github_token | A default GitHub Access Token.
This is used if `github_token` and `app_id`/`app_private_key` are not specified.
contents:write - Push commits
| no | ${{ github.token }} |
| app_id | GitHub App ID
| no | — |
| app_private_key | GitHub App Private Key
| no | — |
| commit_message | Commit message.
If empty, defaults to "empty commit" when empty_commit is true, otherwise "commit changes".
| no | — |
| branch | A Pushed branch.
By default, GITHUB_HEAD_REF or GITHUB_REF_NAME is used.
| no | — |
| parent_branch | If a branch is newly created, the parent branch is used as the base branch.
By default, the default branch is used.
| no | — |
| repository | A Pushed repository.
By default, GITHUB_REPOSITORY is used.
| no | — |
| root_dir | The Git root directory for the files to commit.
| no | — |
| files | Files to commit. Unchanged files are ignored.
To specify multiple files, separate them with a newline.
By default, all modified and untracked files are committed.
git ls-files --modified --others --exclude-standard
| no | — |
| list_files_by_git | If true, the action lists files by git ls-files.
If false, the action lists files by the files input.
| no | true |
| workflow | How to handle changed workflow files.
This input is used if `app_id` and `app_private_key` are specified.
To commit workflow files, the permission `workflows:write` is required.
The following values are available:
1. allow - Grant `workflows:write` permission when creating an access token
2. deny - Fail if workflow files are changed
3. ignore - Ignore workflow files
| no | allow |
| fail_on_self_push | If true (default), the action fails when it pushes a commit to the same repo/branch as the current workflow run.
Set to false to avoid failing and check outputs instead.
| no | true |
| empty_commit | If true, the action creates an empty commit when no files are changed.
| no | false |
| force_push | If true, the action pushes a commit forcibly.
| no | false |
| orphan | If true, the action creates an orphan branch.
| no | false |
| use_base_tree | If true, the action uses a base tree.
| no | true |