Managing scheduled reminders for your team

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."

GitHub will only trigger reminders for up to five repositories per owner and 20 pull requests per repository.

Creating a scheduled reminder for a team

1. In the top right corner of GitHub, click your profile photo, then click Your organizations.

2. Click the name of your organization.

3. Under your organization name, click Teams.

   

4. On the Teams tab, click the name of the team.

5. At the top of the team page, click Settings.

6. In the left sidebar, click Scheduled reminders.

7. Under "Scheduled reminders", click Add your first reminder.

8. Under "Slack workspace", click Authorize Slack workspace and follow the instructions.

9. Under "Slack channel", type the name of the Slack channel where you'd like to receive notifications.

10. Under "Days", click Weekdays to select one or more days you'd like to receive scheduled reminders.

11. 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.

12. 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.

    

13. Optionally, to exclude draft pull requests from scheduled reminders, select Ignore drafts. For more information, see "Draft pull requests."

14. 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.

15. 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.

16. 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.

17. 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.

18. 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.

19. 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.

20. 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.

21. 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.

22. Click Create reminder.

Managing a scheduled reminder for a team

1. In the top right corner of GitHub, click your profile photo, then click Your organizations.

2. Click the name of your organization.

3. Under your organization name, click Teams.

   

4. On the Teams tab, click the name of the team.

5. At the top of the team page, click Settings.

6. In the left sidebar, click Scheduled reminders.

7. Next to the scheduled reminder you'd like to update, click Edit.

8. Make one or more changes to your scheduled reminder.

9. 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

1. In the top right corner of GitHub, click your profile photo, then click Your organizations.

2. Click the name of your organization.

3. Under your organization name, click Teams.

   

4. On the Teams tab, click the name of the team.

5. At the top of the team page, click Settings.

6. In the left sidebar, click Scheduled reminders.

7. At the bottom of the page, click Delete this reminder.

8. To confirm that you want to delete the scheduled reminder, click OK.

Further reading

• "Managing scheduled reminders for your organization"
• "Managing your scheduled reminders"