Skip to main content

Managing scheduled reminders for your team

You can get reminders in Slack when your team has pull requests waiting for review.

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. Reminders are not sent when changes are merged from upstream into a fork.

Creating a scheduled reminder for a team

  1. In the upper-right corner of GitHub.com, select your profile photo, then click Your organizations.

    Screenshot of the dropdown menu under @octocat's profile picture. "Your organizations" is outlined in dark orange.

  2. Click the name of your organization.

  3. Under your organization name, click Teams.

    Screenshot of the horizontal navigation bar for an organization. A tab, labeled with the people icon and "Teams," is outlined in dark orange.

  4. Click the name of the team.

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

    Screenshot of the header of a team's page. A tab, labeled with a gear icon and "Settings", is outlined in dark orange.

  6. In the "Integrations" section of the 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 "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. Screenshot of Scheduled reminder settings showing drop-down menus to select hours and the associated time zone for reminders in Slack. The hours menu is open, with checkmarks next to 9:00 AM and 10:00 AM.

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

  23. Optionally, to test your reminder, click .

Managing a scheduled reminder for a team

  1. In the upper-right corner of GitHub.com, select your profile photo, then click Your organizations.

    Screenshot of the dropdown menu under @octocat's profile picture. "Your organizations" is outlined in dark orange.

  2. Click the name of your organization.

  3. Under your organization name, click Teams.

    Screenshot of the horizontal navigation bar for an organization. A tab, labeled with the people icon and "Teams," is outlined in dark orange.

  4. Click the name of the team.

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

    Screenshot of the header of a team's page. A tab, labeled with a gear icon and "Settings", is outlined in dark orange.

  6. In the "Integrations" section of the 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.

  10. Optionally, to test your reminder, click .

Deleting a scheduled reminder for a team

  1. In the upper-right corner of GitHub.com, select your profile photo, then click Your organizations.

    Screenshot of the dropdown menu under @octocat's profile picture. "Your organizations" is outlined in dark orange.

  2. Click the name of your organization.

  3. Under your organization name, click Teams.

    Screenshot of the horizontal navigation bar for an organization. A tab, labeled with the people icon and "Teams," is outlined in dark orange.

  4. Click the name of the team.

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

    Screenshot of the header of a team's page. A tab, labeled with a gear icon and "Settings", is outlined in dark orange.

  6. In the "Integrations" section of the 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