Close Stale Issues and PRs

Warns and then closes issues and PRs that have had no activity for a specified amount of time.

All options

List of options

Every argument is optional.

Input	Description
repo-token	PAT(Personal Access Token) for authorizing repository. Defaults to ${{ github.token }}.
days-before-stale	Idle number of days before marking an issue/PR as stale. Defaults to 60.
days-before-issue-stale	Idle number of days before marking an issue as stale. Override days-before-stale.
days-before-pr-stale	Idle number of days before marking an PR as stale. Override days-before-stale.
days-before-close	Idle number of days before closing an stale issue/PR. Defaults to 7.
days-before-issue-close	Idle number of days before closing an stale issue. Override days-before-close.
days-before-pr-close	Idle number of days before closing an stale PR. Override days-before-close.
stale-issue-message	Message to post on the stale issue.
stale-pr-message	Message to post on the stale PR.
close-issue-message	Message to post on the stale issue while closing it.
close-pr-message	Message to post on the stale PR while closing it.
stale-issue-label	Label to apply on the stale issue. Defaults to Stale.
close-issue-label	Label to apply on closing issue. Automatically removed if no longer closed nor locked).
stale-pr-label	Label to apply on the stale PR. Defaults to Stale.
close-pr-label	Label to apply on the closing PR. Automatically removed if no longer closed nor locked).
exempt-issue-labels	Labels on an issue exempted from being marked as stale.
exempt-pr-labels	Labels on the PR exempted from being marked as stale.
only-labels	Only issues and PRs with ALL these labels are checked. Separate multiple labels with commas (eg. "question,answered").
only-issue-labels	Only issues with ALL these labels are checked. Separate multiple labels with commas (eg. "question,answered"). Override only-labels.
only-pr-labels	Only PRs with ALL these labels are checked. Separate multiple labels with commas (eg. "question,answered"). Override only-labels.
any-of-labels	Only issues and PRs with ANY of these labels are checked. Separate multiple labels with commas (eg. "incomplete,waiting-feedback").
operations-per-run	Maximum number of operations per run. GitHub API CRUD related. Defaults to 30.
remove-stale-when-updated	Remove stale label from issue/PR on updates or comments. Defaults to true.
debug-only	Dry-run on action. Defaults to false.
ascending	Order to get issues/PR. true is ascending, false is descending. Defaults to false.
skip-stale-issue-message	Skip adding stale message on stale issue. Defaults to false.
skip-stale-pr-message	Skip adding stale message on stale PR. Defaults to false.
start-date	The date used to skip the stale action on issue/PR created before it. ISO 8601 or RFC 2822.
delete-branch	Delete the git branch after closing a stale pull request. Defaults to false.
exempt-milestones	Milestones on an issue or a PR exempted from being marked as stale.
exempt-issue-milestones	Milestones on an issue exempted from being marked as stale. Override exempt-milestones.
exempt-pr-milestones	Milestones on the PR exempted from being marked as stale. Override exempt-milestones.
exempt-all-milestones	Exempt all issues and PRs with milestones from being marked as stale. Priority over exempt-milestones rules.
exempt-all-issue-milestones	Exempt all issues with milestones from being marked as stale. Override exempt-all-milestones.
exempt-all-pr-milestones	Exempt all PRs with milestones from being marked as stale. Override exempt-all-milestones.
exempt-assignees	Assignees on an issue or a PR exempted from being marked as stale.
exempt-issue-assignees	Assignees on an issue exempted from being marked as stale. Override exempt-assignees.
exempt-pr-assignees	Assignees on the PR exempted from being marked as stale. Override exempt-assignees.
exempt-all-assignees	Exempt all issues and PRs with assignees from being marked as stale. Priority over exempt-assignees rules.
exempt-all-issue-assignees	Exempt all issues with assignees from being marked as stale. Override exempt-all-assignees.
exempt-all-pr-assignees	Exempt all PRs with assignees from being marked as stale. Override exempt-all-assignees.
enable-statistics	Display some statistics at the end of the logs regarding the stale workflow. Only when the logs are enabled. Defaults to true.

Detailed options

operations-per-run

Used to limit the number of operations made with the GitHub API to avoid reaching the rate limit.
Based on your project, your GitHub business plan and the date of the cron job you set for this action, you can increase this limit to a higher number.

When debugging, you can set it to a much higher number like 1000 since there will be fewer operations made with the GitHub API.
Only the actor and the batch of issues (100 per batch) will consume the operations.

Default value: 30

Usage

See also action.yml for a comprehensive list of all the options.

Basic:

name: 'Close stale issues and PRs'
on:
  schedule:
    - cron: '30 1 * * *'

jobs:
  stale:
    runs-on: ubuntu-latest
    steps:
      - uses: actions/stale@v3
        with:
          stale-issue-message: 'Message to comment on stale issues. If none provided, will not mark issues stale'
          stale-pr-message: 'Message to comment on stale PRs. If none provided, will not mark PRs stale'

Configure stale timeouts:

name: 'Close stale issues and PRs'
on:
  schedule:
    - cron: '30 1 * * *'

jobs:
  stale:
    runs-on: ubuntu-latest
    steps:
      - uses: actions/stale@v3
        with:
          stale-issue-message: 'This issue is stale because it has been open 30 days with no activity. Remove stale label or comment or this will be closed in 5 days.'
          days-before-stale: 30
          days-before-close: 5

Configure different stale timeouts but never close a PR:

name: 'Close stale issues and PR'
on:
  schedule:
    - cron: '30 1 * * *'

jobs:
  stale:
    runs-on: ubuntu-latest
    steps:
      - uses: actions/stale@v3
        with:
          repo-token: ${{ secrets.GITHUB_TOKEN }}
          stale-issue-message: 'This issue is stale because it has been open 30 days with no activity. Remove stale label or comment or this will be closed in 5 days.'
          stale-pr-message: 'This PR is stale because it has been open 45 days with no activity. Remove stale label or comment or this will be closed in 10 days.'
          close-issue-message: 'This issue was closed because it has been stalled for 5 days with no activity.'
          days-before-stale: 30
          days-before-close: 5
          days-before-pr-close: -1

Configure different stale timeouts:

name: 'Close stale issues and PRs'
on:
  schedule:
    - cron: '30 1 * * *'

jobs:
  stale:
    runs-on: ubuntu-latest
    steps:
      - uses: actions/stale@v3
        with:
          repo-token: ${{ secrets.GITHUB_TOKEN }}
          stale-issue-message: 'This issue is stale because it has been open 30 days with no activity. Remove stale label or comment or this will be closed in 5 days.'
          stale-pr-message: 'This PR is stale because it has been open 45 days with no activity. Remove stale label or comment or this will be closed in 10 days.'
          close-issue-message: 'This issue was closed because it has been stalled for 5 days with no activity.'
          close-pr-message: 'This PR was closed because it has been stalled for 10 days with no activity.'
          days-before-issue-stale: 30
          days-before-pr-stale: 45
          days-before-issue-close: 5
          days-before-pr-close: 10

Configure labels:

name: 'Close stale issues and PRs'
on:
  schedule:
    - cron: '30 1 * * *'

jobs:
  stale:
    runs-on: ubuntu-latest
    steps:
      - uses: actions/stale@v3
        with:
          stale-issue-message: 'Stale issue message'
          stale-pr-message: 'Stale pull request message'
          stale-issue-label: 'no-issue-activity'
          exempt-issue-labels: 'awaiting-approval,work-in-progress'
          stale-pr-label: 'no-pr-activity'
          exempt-pr-labels: 'awaiting-approval,work-in-progress'
          only-labels: 'awaiting-feedback,awaiting-answers'

Configure the stale action to only stale issue/PR created after the 18th april 2020:

name: 'Close stale issues and PRs'
on:
  schedule:
    - cron: '30 1 * * *'

jobs:
  stale:
    runs-on: ubuntu-latest
    steps:
      - uses: actions/stale@v3
        with:
          start-date: '2020-18-04T00:00:00Z' // ISO 8601 or RFC 2822

Avoid stale for specific milestones:

name: 'Close stale issues and PRs'
on:
  schedule:
    - cron: '30 1 * * *'

jobs:
  stale:
    runs-on: ubuntu-latest
    steps:
      - uses: actions/stale@v3
        with:
          exempt-issue-milestones: 'future,alpha,beta'
          exempt-pr-milestones: 'bugfix,improvement'

Avoid stale for all PR with milestones:

name: 'Close stale issues and PRs'
on:
  schedule:
    - cron: '30 1 * * *'

jobs:
  stale:
    runs-on: ubuntu-latest
    steps:
      - uses: actions/stale@v3
        with:
          exempt-all-pr-milestones: true

Avoid stale for specific labels:

name: 'Close stale issues and PRs'
on:
  schedule:
    - cron: '30 1 * * *'

jobs:
  stale:
    runs-on: ubuntu-latest
    steps:
      - uses: actions/stale@v3
        with:
          any-of-labels: 'needs-more-info,needs-demo'
          # You can opt for 'only-labels' instead if your usecase requires all labels
          # to be present in the issue/PR

Avoid stale for specific assignees:

name: 'Close stale issues and PRs'
on:
  schedule:
    - cron: '30 1 * * *'

jobs:
  stale:
    runs-on: ubuntu-latest
    steps:
      - uses: actions/stale@v3
        with:
          exempt-issue-assignees: 'marco,polo'
          exempt-pr-assignees: 'marco'

Avoid stale for all PR with assignees:

name: 'Close stale issues and PRs'
on:
  schedule:
    - cron: '30 1 * * *'

jobs:
  stale:
    runs-on: ubuntu-latest
    steps:
      - uses: actions/stale@v3
        with:
          exempt-all-pr-assignees: true

Debugging

Logs:
To see the debug output from this action, you must set the secret ACTIONS_STEP_DEBUG to true in your repository.
There is a lot of logs so this can be very helpful!

Statistics:
If the logs are enabled, you can also enable the statistics log which will be visible at the end of the logs once all issues were processed.
This is very helpful to have a quick understanding of the whole stale workflow.
Set enable-statistics to true in your workflow configuration file.

Dry-run:
You can run this action in debug only mode (no actions will be taken on your issues and pull requests) by passing debug-only to true as an argument to the action.

More operations:
You can increase the maximum number of operations per run by passing operations-per-run to 1000 for example which will help you to handle more operations in a single stale workflow run.
If the debug-only option is enabled, this is very helpful because the workflow will (almost) never reach the GitHub API rate, and you will be able to deep-dive into the logs.

Job frequency:
You could change the cron job frequency in the stale workflow to run the stale workflow more often.
Usually this is not very helpful though.

Contributing

You wish to contribute?
Check out the contributing file before helping us.