{"id":13539887,"url":"https://github.com/googleapis/release-please-action","last_synced_at":"2025-05-14T05:02:22.563Z","repository":{"id":37562630,"uuid":"262236530","full_name":"googleapis/release-please-action","owner":"googleapis","description":"automated releases based on conventional commits","archived":false,"fork":false,"pushed_at":"2025-03-12T14:07:57.000Z","size":31443,"stargazers_count":1914,"open_issues_count":97,"forks_count":235,"subscribers_count":33,"default_branch":"main","last_synced_at":"2025-05-05T19:15:07.652Z","etag":null,"topics":[],"latest_commit_sha":null,"homepage":"","language":"TypeScript","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"apache-2.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/googleapis.png","metadata":{"files":{"readme":"README.md","changelog":"CHANGELOG.md","contributing":"CONTRIBUTING.md","funding":null,"license":"LICENSE","code_of_conduct":"CODE_OF_CONDUCT.md","threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":"SECURITY.md","support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null}},"created_at":"2020-05-08T05:38:04.000Z","updated_at":"2025-05-05T15:47:06.000Z","dependencies_parsed_at":"2023-09-28T18:59:13.049Z","dependency_job_id":"cbe3e99c-a709-468c-8fb0-18ed14809d5d","html_url":"https://github.com/googleapis/release-please-action","commit_stats":{"total_commits":587,"total_committers":77,"mean_commits":7.623376623376624,"dds":0.616695059625213,"last_synced_commit":"d1a8f221d7723166f48a584aebba00ef3f6febec"},"previous_names":["googleapis/release-please-action","google-github-actions/release-please-action"],"tags_count":179,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/googleapis%2Frelease-please-action","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/googleapis%2Frelease-please-action/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/googleapis%2Frelease-please-action/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/googleapis%2Frelease-please-action/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/googleapis","download_url":"https://codeload.github.com/googleapis/release-please-action/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":254076344,"owners_count":22010597,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":[],"created_at":"2024-08-01T09:01:33.497Z","updated_at":"2025-05-14T05:02:22.443Z","avatar_url":"https://github.com/googleapis.png","language":"TypeScript","funding_links":[],"categories":["TypeScript","Browse The Shelves"],"sub_categories":["Repo automation tools"],"readme":"# Release Please Action\n\n[![Conventional Commits](https://img.shields.io/badge/Conventional%20Commits-1.0.0-yellow.svg)](https://conventionalcommits.org)\n\nAutomate releases with Conventional Commit Messages.\n\n## Basic Configuration\n\n1. Create a `.github/workflows/release-please.yml` file with these contents:\n\n   ```yaml\n   on:\n     push:\n       branches:\n         - main\n\n   permissions:\n     contents: write\n     pull-requests: write\n\n   name: release-please\n\n   jobs:\n     release-please:\n       runs-on: ubuntu-latest\n       steps:\n         - uses: googleapis/release-please-action@v4\n           with:\n             # this assumes that you have created a personal access token\n             # (PAT) and configured it as a GitHub action secret named\n             # `MY_RELEASE_PLEASE_TOKEN` (this secret name is not important).\n             token: ${{ secrets.MY_RELEASE_PLEASE_TOKEN }}\n             # this is a built-in strategy in release-please, see \"Action Inputs\"\n             # for more options\n             release-type: simple\n   ```\n\n   Specifying a `release-type` configuration is the most straight-forward\n   configuration option, but allows for no further customization. For advanced\n   configuration options, see the [Advanced Configuration section](#advanced-release-configuration)\n\n2. Merge the above action into your repository and make sure new commits follow\n   the [Conventional Commits](https://www.conventionalcommits.org/en/v1.0.0/)\n   convention, [release-please](https://github.com/googleapis/release-please)\n   will start creating Release PRs for you.\n\n## Advanced Release Configuration\n\nFor any advanced configuration, please set up a\n[manifest config](https://github.com/googleapis/release-please/blob/master/docs/manifest-releaser.md)\nand then configure this action as follows:\n\n```yaml\n#...(same as above)\nsteps:\n  - uses: googleapis/release-please-action@v4\n    with:\n      # this assumes that you have created a personal access token\n      # (PAT) and configured it as a GitHub action secret named\n      # `MY_RELEASE_PLEASE_TOKEN` (this secret name is not important).\n      token: ${{ secrets.MY_RELEASE_PLEASE_TOKEN }}\n      # optional. customize path to release-please-config.json\n      config-file: release-please-config.json\n      # optional. customize path to .release-please-manifest.json\n      manifest-file: .release-please-manifest.json\n```\n\n## Action Inputs\n\n| input                      | description                                                                                                                            |\n| -------------------------- | -------------------------------------------------------------------------------------------------------------------------------------- |\n| `token`                    | A GitHub secret token, the action defaults to using the special `secrets.GITHUB_TOKEN`                                                 |\n| `release-type`             | If specified, defines the release strategy to use for the repository. Reference [Release types supported](#release-types-supported)    |\n| `path`                     | create a release from a path other than the repository's root                                                                          |\n| `target-branch`            | branch to open pull release PR against (detected by default)                                                                           |\n| `config-file`              | Path to the release-please config in the repository. Defaults to `release-please-config.json`                                          |\n| `manifest-file`            | Path to the release-please versions manifest. Defaults to `.release-please-manifest.json`                                              |\n| `repo-url`                 | GitHub repository name in the form of `\u003cowner\u003e/\u003crepo\u003e`. Defaults to the repository the action is running in.                           |\n| `github-api-url`           | Override the GitHub API URL.                                                                                                           |\n| `github-graphql-url`       | Override the GitHub GraphQL URL                                                                                                        |\n| `fork`                     | If `true`, send the PR from a fork. This requires the `token` to be a user that can create forks (e.g. not the default `GITHUB_TOKEN`) |\n| `include-component-in-tag` | If true, add prefix to tags and branches, allowing multiple libraries to be released from the same repository                          |\n| `proxy-server`             | Configure a proxy servier in the form of `\u003chost\u003e:\u003cport\u003e` e.g. `proxy-host.com:8080`                                                    |\n| `skip-github-release`      | If `true`, do not attempt to create releases. This is useful if splitting release tagging from PR creation.                            |\n| `skip-github-pull-request` | If `true`, do not attempt to create release pull requests. This is useful if splitting release tagging from PR creation.               |\n| `skip-labeling`            | If `true`, do not attempt to label the PR.                                                                                          |\n\n## GitHub Credentials\n\n`release-please` requires a GitHub token to access the GitHub API. You configure this token via\nthe `token` configuration option.\n\nIf your repository is in an organization, you may need to\n[permit github actions to create an approve PRs](https://stackoverflow.com/questions/72376229).\n\n\u003e [!WARNING]  \n\u003e If using GitHub Actions, you will need to specify a `token` for your workflows to run on\n\u003e Release Please's releases and PRs. See [the heading below](#other-actions-on-release-please-prs).\n\n### Other Actions on Release Please PRs\n\nBy default, Release Please uses the built-in `GITHUB_TOKEN` secret. However, all resources created\nby `release-please` (release tag or release pull request) will not trigger future GitHub actions workflows,\nand workflows normally triggered by `release.created` events will also not run.\nFrom GitHub's\n[docs](https://docs.github.com/en/actions/using-workflows/triggering-a-workflow#triggering-a-workflow-from-a-workflow):\n\n\u003e When you use the repository's `GITHUB_TOKEN` to perform tasks, events triggered by the `GITHUB_TOKEN`\n\u003e will not create a new workflow run. This prevents you from accidentally creating recursive workflow runs.\n\nYou will want to configure a GitHub Actions secret with a\n[Personal Access Token](https://docs.github.com/en/authentication/keeping-your-account-and-data-secure/creating-a-personal-access-token)\nif you want GitHub Actions CI checks to run on Release Please PRs.\n\n### Workflow Permissions\n\nThis workflow will need the following permissions in your workflow file:\n\n```yml\npermissions:\n  contents: write\n  pull-requests: write\n```\n\nYou may also need to set \"Allow GitHub Actions to create and approve pull requests\" under\nrepository Settings \u003e Actions \u003e General.\n\nFor more information about permissions:\n\n- GitHub APIs [protected by `contents` permission](https://docs.github.com/en/rest/overview/permissions-required-for-github-apps?apiVersion=2022-11-28#contents)\n- GitHub APIs [protected by `pull_requests` permission](https://docs.github.com/en/rest/overview/permissions-required-for-github-apps?apiVersion=2022-11-28#pull-requests)\n- Github Actions: [permissions for the `GITHUB_TOKEN`](https://docs.github.com/en/actions/security-guides/automatic-token-authentication#permissions-for-the-github_token)\n- Github Repositories: [enabling workflows for forks of private repositories](https://docs.github.com/en/repositories/managing-your-repositorys-settings-and-features/enabling-features-for-your-repository/managing-github-actions-settings-for-a-repository#enabling-workflows-for-private-repository-forks)\n- Github Actions: [assigning permissions to jobs](https://docs.github.com/en/actions/using-jobs/assigning-permissions-to-jobs)\n\n### Release Types Supported\n\nRelease Please automates releases for the following flavors of repositories:\n\n| release type       | description                                                                                                                                                                                        |\n| ------------------ | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |\n| `dart` | A repository with a pubspec.yaml and a CHANGELOG.md |\n| `elixir`           | An elixir repository with a mix.exs and a CHANGELOG.md                                                                                                                                             |\n| `expo` | An Expo based React Native repository, with a package.json, app.json and CHANGELOG.md |\n| `go`               | Go repository, with a CHANGELOG.md                                                                                                                                                                 |\n| `helm`             | A helm chart repository with a Chart.yaml and a CHANGELOG.md                                                                                                                                       |\n| `java`             | [A strategy that generates SNAPSHOT version after each release](https://github.com/googleapis/release-please/blob/main/docs/java.md)                                                               |\n| `krm-blueprint` | [A kpt package, with 1 or more KRM files and a CHANGELOG.md](https://github.com/GoogleCloudPlatform/blueprints/tree/main/catalog/project) |\n| `maven`            | [Strategy for Maven projects, generates SNAPSHOT version after each release and updates `pom.xml` automatically](https://github.com/googleapis/release-please/blob/main/docs/java.md)              |\n| `node`             | [A Node.js repository, with a package.json and CHANGELOG.md](https://github.com/yargs/yargs)                                                                                                       |\n| `ocaml`            | [An OCaml repository, containing 1 or more opam or esy files and a CHANGELOG.md](https://github.com/grain-lang/binaryen.ml)                                                                        |\n| `python`           | [A Python repository, with a setup.py, setup.cfg, version.py and CHANGELOG.md](https://github.com/googleapis/python-storage) and optionally a pyproject.toml and a \u0026lt;project\u0026gt;/\\_\\_init\\_\\_.py |\n| `php`              | [A php composer package with composer.json and CHANGELOG.md](https://github.com/setnemo/asterisk-notation)                                                                                         |\n| `ruby`             | [A Ruby repository, with version.rb and CHANGELOG.md](https://github.com/google/google-id-token)                                                                                                   |\n| `rust`             | A Rust repository, with a Cargo.toml (either as a crate or workspace) and a CHANGELOG.md                                                                                                           |\n| `sfdx`             | A repository with a [sfdx-project.json](https://developer.salesforce.com/docs/atlas.en-us.sfdx_dev.meta/sfdx_dev/sfdx_dev_ws_config.htm) and a CHANGELOG.md                                        |\n| `simple`           | [A repository with a version.txt and a CHANGELOG.md](https://github.com/googleapis/gapic-generator)                                                                                                |\n| `terraform-module` | [A terraform module, with a version in the README.md, and a CHANGELOG.md](https://github.com/terraform-google-modules/terraform-google-project-factory)                                            |\n\nNew types of releases can be [added here](https://github.com/googleapis/release-please/tree/main/src/strategies).\n\n\u003e You can also find them in the [release-please repository](https://github.com/googleapis/release-please/tree/main#strategy-language-types-supported).\n\n## Outputs\n\n\u003e Properties that are available after the action executed.\n\n| output             | description                                                                                                                                                       |\n| ------------------ | ----------------------------------------------------------------------------------------------------------------------------------------------------------------- |\n| `releases_created` | `true` if any release was created, `false` otherwise                                                                                                              |\n| `paths_released`   | A JSON string of the array of paths that had releases created (`[]` if nothing was released)                                                                                          |\n| `prs_created`      | `true` if any pull request was created or updated                                                                                                                 |\n| `pr`               | A JSON string of the [PullRequest object](https://github.com/googleapis/release-please/blob/main/src/pull-request.ts#L15) (unset if no release created)           |\n| `prs`              | A JSON string of the array of [PullRequest objects](https://github.com/googleapis/release-please/blob/main/src/pull-request.ts#L15) (unset if no release created) |\n\n### Root component outputs\n\nIf you have a root component (path is `.` or unset), then the action will also output:\n\n| output               | description                                                                                                |\n| -------------------- | ---------------------------------------------------------------------------------------------------------- |\n| `release_created`    | `true` if a root component release was created, `false` otherwise                                          |\n| `upload_url`         | Directly related to [**Create a release**](https://developer.github.com/v3/repos/releases/#response-4) API |\n| `html_url`           | Directly related to [**Create a release**](https://developer.github.com/v3/repos/releases/#response-4) API |\n| `tag_name`           | Directly related to [**Create a release**](https://developer.github.com/v3/repos/releases/#response-4) API |\n| `version`            | Number representing full semver value                                                                      |\n| `major`              | Number representing major semver value                                                                     |\n| `minor`              | Number representing minor semver value                                                                     |\n| `patch`              | Number representing patch semver value                                                                     |\n| `sha`                | SHA that a GitHub release was tagged at                                                                    |\n\n### Path outputs\n\nIf you have a monorepo or a component with `path` different than the root (`.`)\ndirectory, then your outputs will have the `path` prefixed to the output name.\n\nThis prefix allows you to distinguish values for different releases.\n\n| output                    | description                                                                                                |\n| ------------------------- | ---------------------------------------------------------------------------------------------------------- |\n| `\u003cpath\u003e--release_created` | `true` if the release was created, `false` otherwise                                                       |\n| `\u003cpath\u003e--upload_url`      | Directly related to [**Create a release**](https://developer.github.com/v3/repos/releases/#response-4) API |\n| `\u003cpath\u003e--html_url`        | Directly related to [**Create a release**](https://developer.github.com/v3/repos/releases/#response-4) API |\n| `\u003cpath\u003e--tag_name`        | Directly related to [**Create a release**](https://developer.github.com/v3/repos/releases/#response-4) API |\n| `\u003cpath\u003e--version`         | Number representing full semver value                                                                      |\n| `\u003cpath\u003e--major`           | Number representing major semver value                                                                     |\n| `\u003cpath\u003e--minor`           | Number representing minor semver value                                                                     |\n| `\u003cpath\u003e--patch`           | Number representing patch semver value                                                                     |\n| `\u003cpath\u003e--sha`             | sha that a GitHub release was tagged at                                                                    |\n\nIf the path contains `/` you can access the outputs by using javascript like property access `steps.release.outputs[\u003cpath\u003e--...]` \ne.g.:\n\n```yaml\nrun: npm publish --workflow packages/my-module\nif: ${{ steps.release.outputs['packages/my-module--release_created'] }}\n```\n\n## How release please works\n\nRelease Please automates CHANGELOG generation, the creation of GitHub releases,\nand version bumps for your projects. Release Please does so by parsing your\ngit history, looking for [Conventional Commit messages](https://www.conventionalcommits.org/),\nand creating release PRs.\n\n### What's a Release PR?\n\nRather than continuously releasing what's landed to your default branch,\nrelease-please maintains Release PRs:\n\n\u003cimg width=\"400\" src=\"/screen.png\"\u003e\n\nThese Release PRs are kept up-to-date as additional work is merged. When you're\nready to tag a release, simply merge the release PR.\n\n### How should I write my commits?\n\nRelease Please assumes you are using [Conventional Commit messages](https://www.conventionalcommits.org/).\n\nThe most important prefixes you should have in mind are:\n\n- `fix:` which represents bug fixes, and correlates to a [SemVer](https://semver.org/)\n  patch.\n- `feat:` which represents a new feature, and correlates to a SemVer minor.\n- `feat!:`, or `fix!:`, `refactor!:`, etc., which represent a breaking change\n  (indicated by the `!`) and will result in a SemVer major.\n\n### Supporting multiple release branches\n\n`release-please` has the ability to target not default branches. You can even use separate release strategies (`release-type`).\nTo configure, simply configure multiple workflows that specify a different `target-branch`:\n\nConfiguration for `main` (default) branch (`.github/workflows/release-main.yaml`):\n\n```yaml\non:\n  push:\n    branches:\n      - main\n      - 1.x\nname: release-please\njobs:\n  release-please:\n    runs-on: ubuntu-latest\n    steps:\n      - uses: googleapis/release-please-action@v4\n        with:\n          release-type: node\n          # The short ref name of the branch or tag that triggered\n          #  the workflow run. For example, `main` or `1.x`\n          target-branch: ${{ github.ref_name }}\n```\n\n## Automating publication to npm\n\nWith a few additions, the Release Please action can be made to publish to\nnpm when a Release PR is merged:\n\n```yaml\non:\n  push:\n    branches:\n      - main\nname: release-please\njobs:\n  release-please:\n    runs-on: ubuntu-latest\n    steps:\n      - uses: googleapis/release-please-action@v4\n        id: release\n        with:\n          release-type: node\n      # The logic below handles the npm publication:\n      - uses: actions/checkout@v4\n        # these if statements ensure that a publication only occurs when\n        # a new release is created:\n        if: ${{ steps.release.outputs.release_created }}\n      - uses: actions/setup-node@v4\n        with:\n          node-version: 12\n          registry-url: 'https://registry.npmjs.org'\n        if: ${{ steps.release.outputs.release_created }}\n      - run: npm ci\n        if: ${{ steps.release.outputs.release_created }}\n      - run: npm publish\n        env:\n          NODE_AUTH_TOKEN: ${{secrets.NPM_TOKEN}}\n        if: ${{ steps.release.outputs.release_created }}\n```\n\n\u003e So that you can keep 2FA enabled for npm publications, we recommend setting\n\u003e `registry-url` to your own [Wombat Dressing Room](https://github.com/GoogleCloudPlatform/wombat-dressing-room) deployment.\n\n## Creating major/minor tags\n\nIf you are using release-please to publish a GitHub action, you will\nlikely want to tag a major and minor tag during a release, i.e., if you\nare releasing `v2.8.3`, you will also want to update tags `v2` and `v2.8`. This allows your\nusers to pin to `v2`, and get updates to your library without updating their\nworkflows.\n\nThe `release-please-action` has the outputs `major`, `minor`, and\n`release_created` to facilitate this. These outputs can be used conditionally,\nlike so:\n\n```yaml\non:\n  push:\n    branches:\n      - main\nname: release-please\njobs:\n  release-please:\n    runs-on: ubuntu-latest\n    steps:\n      - uses: googleapis/release-please-action@v4\n        id: release\n        with:\n          release-type: node\n      - uses: actions/checkout@v4\n      - name: tag major and minor versions\n        if: ${{ steps.release.outputs.release_created }}\n        run: |\n          git config user.name github-actions[bot]\n          git config user.email 41898282+github-actions[bot]@users.noreply.github.com\n          git remote add gh-token \"https://${{ secrets.GITHUB_TOKEN }}@github.com/googleapis/release-please-action.git\"\n          git tag -d v${{ steps.release.outputs.major }} || true\n          git tag -d v${{ steps.release.outputs.major }}.${{ steps.release.outputs.minor }} || true\n          git push origin :v${{ steps.release.outputs.major }} || true\n          git push origin :v${{ steps.release.outputs.major }}.${{ steps.release.outputs.minor }} || true\n          git tag -a v${{ steps.release.outputs.major }} -m \"Release v${{ steps.release.outputs.major }}\"\n          git tag -a v${{ steps.release.outputs.major }}.${{ steps.release.outputs.minor }} -m \"Release v${{ steps.release.outputs.major }}.${{ steps.release.outputs.minor }}\"\n          git push origin v${{ steps.release.outputs.major }}\n          git push origin v${{ steps.release.outputs.major }}.${{ steps.release.outputs.minor }}\n```\n\n## Attaching files to the GitHub release\n\nYou can attach additional files, such as release artifacts, to the GitHub release that is created. The `gh` CLI tool, which is installed on all runners, can be used for this.\n\nThis example uses the `gh` tool to attach the file `./artifact/some-build-artifact.zip`:\n\n```yaml\non:\n  push:\n    branches:\n      - main\nname: release-please\njobs:\n  release-please:\n    runs-on: ubuntu-latest\n    steps:\n      - uses: googleapis/release-please-action@v4\n        id: release\n        with:\n          release-type: node\n      - name: Upload Release Artifact\n        if: ${{ steps.release.outputs.release_created }}\n        env:\n          GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }}\n        run: gh release upload ${{ steps.release.outputs.tag_name }} ./artifact/some-build-artifact.zip\n```\n\n## Upgrading from v3 to v4\n\n### Command\n\nIf you were setting the `command` option, you will likely need to modify your configuration.\n\n| Command          | New Configuration                                                | Description                                                                                                                                  |\n| ---------------- | ---------------------------------------------------------------- | -------------------------------------------------------------------------------------------------------------------------------------------- |\n| `github-release` | `skip-github-pull-request: true`                                 | This command was used for only tagging releases. Now we tell release-please to skip opening release PRs.                                      |\n| `release-pr`     | `skip-github-release: true`                                      | This command was used for only opening release PRs. Now we tell release-please to skip tagging releases.                                     |\n| `manifest`       | do not set `release-type` option                                 | This command told release-please to use a manifest config file. This is now the default behavior unless you explicitly set a `release-type`. |\n| `manifest-pr`    | `skip-github-release: true` and do not set `release-type` option | This command told release-please to use a manifest config file and only open the pull reuqest.                                               |\n\n### Package options\n\nIf you were previously configuring advanced options via GitHub action inputs, you\nwill need to configure via the release-please manifest configuration instead. Below,\nyou can see a mapping of the old option to the new option:\n\n| Old Option                         | New Option                                                                            | Notes                                                                               |\n| ---------------------------------- | ------------------------------------------------------------------------------------- | ----------------------------------------------------------------------------------- |\n| `path`                             | `$.packages`                                                                          | The root `packages` field is an object where the key is the `path` being configured |\n| `changelog-path`                   | `$.packages[path].changelog-path`                                                     | Package-only option                                                                 |\n| `component`                        | `$.packages[path].component`                                                          | Package-only option                                                                 |\n| `package-name`                     | `$.packages[path].package-name`                                                       | Package-only option                                                                 |\n| `always-link-local`                | `$.always-link-local`                                                                 | Root-only option                                                                    |\n| `bootstrap-sha`                    | `$.bootstrap-sha`                                                                     | Root-only option                                                                    |\n| `commit-search-depth`              | `$.commit-search-depth`                                                               | Root-only option                                                                    |\n| `group-pull-request-title-pattern` | `$.group-pull-request-title-pattern`                                                  | Root-only option                                                                    |\n| `last-release-sha`                 | `$.last-release-sha`                                                                  | Root-only option                                                                    |\n| `plugins`                          | `$.plugins`                                                                           | Root-only option                                                                    |\n| `release-search-depth`             | `$.release-search-depth`                                                              | Root-only option                                                                    |\n| `sequential-calls`                 | `$.sequential-calls`                                                                  | Root-only option                                                                    |\n| `skip-labeling`                    | `$.skip-labeling`                                                                     | Root-only option                                                                    |\n| `signoff`                          | `$.signoff`                                                                           | Root-only option                                                                    |\n| `bump-minor-pre-major`             | `$.bump-minor-pre-major` or `$.packages[path].bump-minor-pre-major`                   | Root or per-package option                                                          |\n| `bump-patch-for-minor-pre-major`   | `$.bump-path-for-minor-pre-major` or `$.packages[path].bump-path-for-minor-pre-major` | Root or per-package option                                                          |\n| `changelog-host`                   | `$.changelog-host` or `$.packages[path].changelog-host`                               | Root or per-package option                                                          |\n| `changelog-notes-type`             | `$.changelog-type` or `$.packages[path].changelog-type`                               | Root or per-package option                                                          |\n| `changelog-types`                  | `$.changelog-sections` or `$.packages[path].changelog-sections`                       | Root or per-package option                                                          |\n| `extra-files`                      | `$.extra-files` or `$.packages[path].extra-files`                                     | Root or per-package option                                                          |\n| `include-v-in-tag`                 | `$.include-v-in-tag` or `$.packages[path].include-v-in-tag`                           | Root or per-package option                                                          |\n| `labels`                           | `$.label` or `$.packages[path].label`                                                 | Root or per-package option                                                          |\n| `monorepo-tags`                    | `$.include-component-in-tag` or `$.packages[path].include-component-in-tag`           | Root or per-package option                                                          |\n| `prerelease`                       | `$.prerelease` or `$.packages[path].prerelease`                                       | Root or per-package option                                                          |\n| `pull-request-header`              | `$.pull-request-header` or `$.packages[path].pull-request-header`                     | Root or per-package option                                                          |\n| `pull-request-title-pattern`       | `$.pull-request-title-pattern` or `$.packages[path].pull-request-title-pattern`       | Root or per-package option                                                          |\n| `release-as`                       | `$.release-as` or `$.packages[path].release-as`                                       | Root or per-package option                                                          |\n| `release-labels`                   | `$.release-label` or `$.packages[path].release-label`                                 | Root or per-package option                                                          |\n| `release-type`                     | `$.release-type` or `$.packages[path].release-type`                                   | Root or per-package option                                                          |\n| `separate-pull-requests`           | `$.separate-pull-requests` or `$.packages[path].separate-pull-requests`               | Root or per-package option                                                          |\n| `skip-github-release`              | `$.skip-github-release` or `$.packages[path].skip-github-release`                     | Root or per-package option                                                          |\n| `snapshot-labels`                  | `$.snapshot-label` or `$.packages[path].snapshot-label`                               | Root or per-package option                                                          |\n| `tag-separator`                    | `$.tag-separator` or `$.packages[path].tag-separator`                                 | Root or per-package option                                                          |\n| `version-file`                     | `$.version-file` or `$.packages[path].version-file`                                   | Root or per-package option                                                          |\n| `versioning-strategy`              | `$.versioning` or `$.packages[path].versioning`                                       | Root or per-package option                                                          |\n\n## License\n\nApache Version 2.0\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fgoogleapis%2Frelease-please-action","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fgoogleapis%2Frelease-please-action","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fgoogleapis%2Frelease-please-action/lists"}