About scheduled reminders for pull requests
Scheduled reminders help teams focus on the most important review requests that require their attention. Scheduled reminders for pull requests will send a message to your team in Slack with all open pull requests that you or your team have been asked to review, at a specified time. For example, you can create a scheduled reminder to send a message to your team's main communication channel in Slack, including all open pull requests that the team is requested to review, every Wednesday at 9:00 a.m.
Organization owners can schedule a reminder for one or more teams in their organization, for all pull requests the team or teams have been requested to review.
GitHub will only trigger reminders for up to five repositories per owner and 20 pull requests per repository. Reminders are not sent when changes are merged from upstream into a fork.
Creating a scheduled reminder for an organization
- In the upper-right corner of GitHub, select your profile photo, then click Your organizations.
- Next to the organization, click Settings.
- In the "Integrations" section of the sidebar, click Scheduled reminders.
- Under "Scheduled reminders", click Add your first reminder.
- Under "Slack workspace", click Authorize Slack workspace and follow the instructions.
- Under "Slack channel", type the name of the Slack channel where you'd like to receive notifications.
Tip
If this Slack channel is private, you will need to invite the integration into the channel:
/invite @github
. In addition, you need to ask users to run/github signin
in one of their Slack channels, otherwise they will not be @mentioned. For more information, see Getting started in the Slack integrations documentation. - Under "Days", click Weekdays to select one or more days you'd like to receive scheduled reminders.
- Under "Times", click 9:00 AM to select one or more times you'd like to receive scheduled reminders. Optionally, to change your timezone, click next to your current timezone and select a different time zone.
- Under "Tracked repositories," choose which repositories you'd like the team to receive pull request review reminders for.
- To receive reminders for all repositories that the chosen team has access to, click All repositories.
- To receive reminders for a subset of repositories, click Only select repositories, then select one or more repositories that the chosen team has access to.
- Under "Filter by team assigned to review code", select the Add a team dropdown menu and click one or more teams. You can add up to 100 teams. If the team you select doesn't have access to the "Tracked repositories" selected above, you won't be able to create the scheduled reminder.
- Optionally, to exclude draft pull requests from scheduled reminders, select Ignore drafts. For more information, see "About pull requests."
- Optionally, to only include pull requests where a review is specifically requested from the team or a team member, select Require review requests. If you don't select this option, all pull requests are included in the scheduled reminder.
- Optionally, to send reminders to the pull request authors after the review requests have been fulfilled, select Remind authors after reviews and choose the number of reviews required before a reminder is sent.
- Optionally, to turn off scheduled reminders for pull requests that have already been reviewed and approved, select Ignore approved pull requests. Then, click Ignore with 1 or more approvals to choose how many approvals a pull request must have to be ignored.
- Under "Minimum age", type the age of a pull request, in hours. Scheduled reminders won't include pull requests that are newer than this age limit.
- Under "Minimum staleness", type the time since the last activity on a pull request, in hours. Scheduled reminders won't include pull requests whose last activity was more recent than this time.
- Under "Ignored terms", type a comma-separated list of terms that may appear in titles of pull requests. Scheduled reminders won't include any pull requests that contain one or more of these terms in their titles.
- Under "Ignored labels", type a comma-separated list of labels. Scheduled reminders won't include any pull requests that have one or more of these labels.
- Under "Required labels", type a comma-separated list of labels. Scheduled reminders will only include pull requests that haven't already been ignored, if they have one or more of these labels.
- Click Create reminder.
- Optionally, to test your reminder, click .
Managing a scheduled reminder for an organization
- In the upper-right corner of GitHub, select your profile photo, then click Your organizations.
- Next to the organization, click Settings.
- In the "Integrations" section of the sidebar, click Scheduled reminders.
- Next to the scheduled reminder you'd like to update, click Edit.
- Make one or more changes to your scheduled reminder.
- To save your changes, click Update reminder.
- Optionally, to test your reminder, click .
Deleting a scheduled reminder for an organization
- In the upper-right corner of GitHub, select your profile photo, then click Your organizations.
- Next to the organization, click Settings.
- In the "Integrations" section of the sidebar, click Scheduled reminders.
- At the bottom of the page, click Delete this reminder.
- To confirm that you want to delete the scheduled reminder, click OK.
Further reading
- Getting started in the Slack integrations documentation
- "Managing your scheduled reminders"
- "Managing scheduled reminders for your team"