About scheduled reminders for teams
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.
Team maintainers and organization owners can set scheduled reminders for any pull requests that a team has been requested to review. Before you can create a scheduled reminder for your team, an organization owner must authorize your Slack workspace. For more information, see "Managing scheduled reminders for your organization."
Creating a scheduled reminder for a team
- In the top right corner of GitHub, click your profile photo, then click Your profile.
- On the left side of your profile page, under "Organizations", click the icon for your organization.
- Under your organization name, click Teams.
- On the Teams tab, click the name of the team.
- At the top of the team page, click Settings.
- In the left 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.
- Under "Days", click Weekdays to select one or more days you'd like to receive scheduled reminders.
- Under "Select Time(s)", 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.
- Optionally, to exclude draft pull requests from scheduled reminders, select Ignore drafts. For more information, see "Draft 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 the 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.
Managing a scheduled reminder for a team
- In the top right corner of GitHub, click your profile photo, then click Your profile.
- On the left side of your profile page, under "Organizations", click the icon for your organization.
- Under your organization name, click Teams.
- On the Teams tab, click the name of the team.
- At the top of the team page, click Settings.
- In the left 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 changes while updating the changes, click Update and test reminder.
Deleting a scheduled reminder for a team
- In the top right corner of GitHub, click your profile photo, then click Your profile.
- On the left side of your profile page, under "Organizations", click the icon for your organization.
- Under your organization name, click Teams.
- On the Teams tab, click the name of the team.
- At the top of the team page, click Settings.
- In the left 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.