Skip to main content

Managing your scheduled reminders

Get reminders in Slack when you or your team have pull requests waiting for review.

About scheduled reminders for users

Scheduled reminders are used to make sure that users focus on the most important review requests that require their attention. Scheduled reminders for pull requests will send a message to you in Slack with open pull requests needing your review at a specified time. For example, you can setup scheduled reminders to send you a message in Slack every morning at 10 AM with pull requests needing to be reviewed by you or one of your teams.

For certain events, you can also enable real-time alerts for scheduled reminders. Real-time alerts get sent to your Slack channel as soon as an important event, such as when you are assigned a review, takes place.

You can set scheduled reminders for personal or team-level review requests for pull requests in organizations you are a member of. Before you can create a scheduled reminder for yourself, 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 scheduled reminders for your personal account

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

    Screenshot of GitHub's account menu showing options for users to view and edit their profile, content, and settings. The menu item "Settings" is outlined in dark orange.

  2. In the "Integrations" section of the sidebar, click Scheduled reminders.

  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.

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

  10. Optionally, to receive Slack messages as soon as certain events happen, select Enable real-time alerts and select the events to receive real-time alerts for. Enable real-time alerts checkbox

  11. Click Create reminder.

Managing scheduled reminders for your personal account

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

    Screenshot of GitHub's account menu showing options for users to view and edit their profile, content, and settings. The menu item "Settings" is outlined in dark orange.

  2. In the "Integrations" section of the sidebar, click Scheduled reminders.

  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

Deleting scheduled reminders for your personal account

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

    Screenshot of GitHub's account menu showing options for users to view and edit their profile, content, and settings. The menu item "Settings" is outlined in dark orange.

  2. In the "Integrations" section of the sidebar, click Scheduled reminders.

  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.

Further reading