Managing scheduled reminders for pull requests

Scheduled reminders sends a Slack notification to the requested user or team based on the configured settings.

Scheduled reminders for pull requests are available with GitHub Team and GitHub Enterprise Cloud. For more information, see "GitHub's products."

In this article

Scheduled reminders for pull requests are currently in beta and subject to change. To request access to the next beta phase for scheduled reminders, join the waitlist at GitHub Scheduled Reminders.

About scheduled reminders for pull requests

Scheduled reminders for pull requests will send a scheduled message to you or your team in Slack with with all open pull requests that you've been asked to review. For example, you can create a scheduled reminder, to send a message to your team's main communication channel in Slack, with open pull requests that the team is requested to review every Wednesday at 9:00 a.m.

You can schedule reminders for pull requests in your user account to send you a direct message in Slack according to whatever schedule you choose.

Team maintainers and organization owners can set scheduled reminders for any pull requests that a team has been requested to review in the team's settings.

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.

Creating a scheduled reminder for a personal account

  1. In the upper-right corner of any page, click your profile photo, then click Settings.

    Settings icon in the user bar

  2. In the left sidebar, click Scheduled reminders.

    Scheduled reminders button

  3. Next to the organization you'd like to schedule reminders for, click Edit.

    Scheduled reminders edit button

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

    Add reminder button

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

    Authorize Slack workspace button

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

    Days dropdown

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

    Select time(s) dropdowns

  8. Optionally, to receive scheduled reminders for reviews you've been assigned to, select Review requests assigned to you.

    Review requests assigned to you checkbox

  9. Optionally, to receive scheduled reminders for reviews assigned to a team you're a member of, select Review requests assigned to your team.

    Review requests assigned to your team checkbox

  10. Click Create reminder.

Creating a scheduled reminder for a team

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

    Profile photo

  2. On the left side of your profile page, under "Organizations", click the icon for your organization.

    organization icons

  3. Under your organization name, click Teams.

    Teams tab

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

    List of the organization's teams

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

    Team settings tab

  6. In the left sidebar, click Scheduled reminders.

    Scheduled reminders button

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

    Add reminder button

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

    Authorize Slack workspace button

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

    Slack channel field

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

    Days dropdown

  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.

    Select time(s) dropdowns

  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, click All repositories.

    • To receive reminders for a subset of repositories, click Only select repositories, then select one or more repositories.

    Choose tracked repositories

  13. Optionally, to turn off scheduled reminders for requested reviews of draft pull requests, select Ignore drafts. For more information, see "Draft pull requests."

    Ignore draft pull requests checkbox

  14. Optionally, to turn off scheduled reminders for pull requests without any requested reviews, select Ignore pull requests with no review requests.

    Ignore pull requests with no review requests checkbox

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

    Ignore approved pull requests checkbox

  16. Click Create reminder.

Creating a scheduled reminder for an organization

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

    Profile photo

  2. On the left side of your profile page, under "Organizations", click the icon for your organization.

    organization icons

  3. Under your organization name, click Settings.

    Organization settings button

  4. In the left sidebar, click Scheduled reminders.

    Scheduled reminders button

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

    Add reminder button

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

    Authorize Slack workspace button

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

    Slack channel field

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

    Days dropdown

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

    Select time(s) dropdowns

  10. Under "Tracked repositories," choose which repositories you'd like the team to receive pull request review reminders for.

    • To receive reminders for all repositories, click All repositories.

    • To receive reminders for a subset of repositories, click Only select repositories, then select one or more repositories.

    Choose tracked repositories

  11. Under "Filter by team assigned to review code", click the Add a team dropdown and choose one or more teams.

    Add a team dropdown

  12. Optionally, to turn off scheduled reminders for requested reviews of draft pull requests, select Ignore drafts. For more information, see "Draft pull requests."

    Ignore draft pull requests checkbox

  13. Optionally, to turn off scheduled reminders for pull requests without any requested reviews, select Ignore pull requests with no review requests.

    Ignore pull requests with no review requests checkbox

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

    Ignore approved pull requests checkbox

  15. Click Create reminder.

Managing a scheduled reminder for a personal account

  1. In the upper-right corner of any page, click your profile photo, then click Settings.

    Settings icon in the user bar

  2. In the left sidebar, click Scheduled reminders.

    Scheduled reminders button

  3. Next to the organization you'd like to edit scheduled reminders for, click Edit.

    Scheduled reminders edit button

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

  5. To save your changes, click Update reminder. Optionally, to test your changes while updating the changes, click Update and test reminder.

    Update buttons

Managing a scheduled reminder for a team

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

    Profile photo

  2. On the left side of your profile page, under "Organizations", click the icon for your organization.

    organization icons

  3. Under your organization name, click Teams.

    Teams tab

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

    List of the organization's teams

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

    Team settings tab

  6. In the left sidebar, click Scheduled reminders.

    Scheduled reminders button

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

    Edit existing scheduled reminder

  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.

    Update buttons

Managing a scheduled reminder for an organization

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

    Profile photo

  2. On the left side of your profile page, under "Organizations", click the icon for your organization.

    organization icons

  3. Under your organization name, click Settings.

    Organization settings button

  4. In the left sidebar, click Scheduled reminders.

    Scheduled reminders button

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

    Edit existing scheduled reminder

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

  7. To save your changes, click Update reminder. Optionally, to test your changes while updating the changes, click Update and test reminder.

    Update buttons

Deleting a scheduled reminder from a personal account

  1. In the upper-right corner of any page, click your profile photo, then click Settings.

    Settings icon in the user bar

  2. In the left sidebar, click Scheduled reminders.

    Scheduled reminders button

  3. Next to the organization you'd like to delete reminders for, click Edit.

    Scheduled reminders edit button

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

    Delete a scheduled reminder button

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

Deleting a scheduled reminder for a team

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

    Profile photo

  2. On the left side of your profile page, under "Organizations", click the icon for your organization.

    organization icons

  3. Under your organization name, click Teams.

    Teams tab

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

    List of the organization's teams

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

    Team settings tab

  6. In the left sidebar, click Scheduled reminders.

    Scheduled reminders button

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

    Delete a scheduled reminder button

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

Deleting a scheduled reminder for an organization

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

    Profile photo

  2. On the left side of your profile page, under "Organizations", click the icon for your organization.

    organization icons

  3. Under your organization name, click Settings.

    Organization settings button

  4. In the left sidebar, click Scheduled reminders.

    Scheduled reminders button

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

    Delete a scheduled reminder button

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

Ask a human

Can't find what you're looking for?

Contact us