Mobile App Settings

Configure notifications and other mobile app options.

Within the mobile app, you can configure how notifications alert you as well as other app behavior settings.

Notification settings and certain features will depend on your device's operating system. Please refer to the section for your device's operating system for more information.

Configure Android Devices

Notification Settings (Android)

The PagerDuty app must have app notifications enabled in order to access the notification settings. You can enable these in the app via the following steps:

  1. Navigate to More in the top right.
  2. Tap System Notification Settings and ensure Allow notifications is enabled.
Notification settings

Notification settings

High-Urgency Notifications

Tap High-Urgency Notification Settings and ensure Allow notifications is enabled. We recommend choosing a sound and any other alert settings that will help you identify these as high-urgency notifications.

High-Urgency Override System Volume

🚧

Override System Volume Limitations

PagerDuty cannot override the volume for phone call and SMS notifications.

OnePlus devices running on OS 10 and higher do not fully support Override System Volume. These devices may not always override the system volume when the phone is on silent or vibrate mode.

If your phone does not have Do Not Disturb enabled, and your volume slider is set to 0, PagerDuty push notifications will be silent. To change this, tap the High-Urgency Override System Volume checkbox to enable and set your desired volume level.

High-Urgency Override Do Not Disturb

Android's Do Not Disturb mode mutes all calls, notifications and other alerts. In order to receive high-urgency push notifications when Do Not Disturb is enabled, you can follow the steps below:

  1. Navigate to your device's Settings Notifications Do not disturb.
  2. Under Allowed during Do not disturb select App notifications.
  3. Tap Add apps and then select the PagerDuty app.
  4. Tap Done to confirm your selection.

Android's Do Not Disturb Settings

Android's Do Not Disturb Settings

You can confirm this was successfully enabled in the PagerDuty app by navigating to More in the top right. If the steps above were completed, High-Urgency Override Do Not Disturb will show as Enabled.

To have phone call and SMS notifications override Do Not Disturb, open the PagerDuty app and navigate to More in the top right. Tap the Override DND for Starred Contacts checkbox to enable it. This will automatically add the PagerDuty Outgoing Numbers contact to your Favorites list and update your device's Do Not Disturb settings to allow calls and messages from contacts on your Favorites list.

❗️

Android Work Profiles

Due to a Work Profile limitation from Android, overriding System Volume and Do Not Disturb will not work when the PagerDuty app is under a Work Profile.

Possible Workaround:
If you also install the PagerDuty app in your personal profile on the device without any additional steps, you should see the Do Not Disturb settings respected when configuring the app in the work profile.

App Tip Notifications

App Tip Notifications are delivered locally through the mobile app, and will occasionally notify you about new features and PagerDuty tips. Disabling this feature will not affect incident-related notifications or other PagerDuty communications, (e.g., status updates, on-call handoff notifications, responder requests, etc.). Since these are local notifications, the setting selection will not be preserved if you uninstall and re-install the PagerDuty mobile app.

Navigate to More App Tip Notification Settings. Slide the toggle Show notifications to the on or off position.

A screenshot of the Android PagerDuty mobile app showing how to turn App Tip Notifications on or off

App Tip Notifications toggle

If you are using an Android device, you can configure the sound and alert settings for these notifications using the options below.

Low-Urgency Notifications

Low-urgency notifications are silent by default in order to distinguish them from high-urgency notifications. To enable sound for these notifications, tap Low-Urgency Notification Settings and ensure Allow notifications is enabled. Choose a sound and other alert settings.

📘

MIUI and EMUI (Huawei and Xiaomi devices)

For these particular forks of Android, you may not be able to set sounds from the respective High and Low Urgency Notification Settings. Instead, you may need to perform the following:

  1. Navigate to System Notification Settings.
  2. Make sure High and Low Urgency Notifications are enabled.
  3. From here, tap either High or Low Urgency to choose your sound.

On-Call Boosters

On-Call Boosters provide push notifications about changes to your on-call schedules. You will immediately receive a push notification when:

  • You are added to a schedule
  • You are removed from a schedule
  • Changes are made to your on-call shifts within the next eight weeks (e.g., overrides, reordering)

🚧

Notification Exceptions

Please note that notifications will not be sent if the change was made by the user themselves or if the change was made through the REST API.

This feature is enabled by default for all mobile users. To disable On-Call Boosters, navigate to More in the top right On-Call Boosters. Slide the toggle Show notifications to the off position.

Android users can configure the sound and alert settings for these notifications.

All Other Notifications

If you have configured push notifications for status updates and/or on-call handoff notifications, you can configure the sound and other alert settings for these notifications by tapping All Other Notification Settings.

Clear Notifications

If you would like to automatically clear your push notifications when the app is launched, tap the checkbox next to Clear Notifications to enable this option.

App Behavior Settings

Swipe Actions

You may change the swipe actions for responding to PagerDuty incidents. By default, the Right Swipe will Resolve an incident, and the Left Swipe will Acknowledge an incident.

To change either swipe action:

  1. Tap Change to the right.
  2. Select from the available incident actions:
    • Resolve
    • Acknowledge; Snooze
    • Acknowledge; Resolve
    • None

Other Settings

Back Button Never Exits App

To ensure the back button doesn’t exit the app (e.g., during a critical incident), tap the Back Button Never Exits App checkbox to enable.

App Screenshots

If you would like to be able to take screenshots within the app, tap the App Screenshots checkbox to enable. If you would like to ensure your incidents and other information have maximum security, you may want to leave this setting disabled.

Configure iOS Devices

Notification Settings (iOS)

High-Urgency and Low-Urgency Settings

To enable and adjust the sound options for push notifications:

  1. Navigate to More in the top right.
    • If required, toggle Push Notifications on.
  2. Tap High-Urgency and assign a ringtone (Recommended).
  3. Tap Low-Urgency and assign a ringtone (Optional).

📘

Other Notifications

If you have configured push notifications for status updates and/or on-call handoff notifications, these notifications will use your device's Default Alerts (Settings Sounds & Haptics Default Alerts) configuration.

Critical Alerts for High-Urgency

Critical Alerts for iOS allow high-urgency push notifications to bypass an iPhone’s Focus and silent mode settings. You can enable this setting in the mobile app by navigating to More in the top right. Ensure that you have Push Notifications enabled, tap Critical Alerts for High-Urgency and then tap Allow.

Allow Critical Alerts

Allow Critical Alerts

Alternatively, you can enable Critical Alerts by navigating to your device's Settings PagerDuty Notifications and then toggle Critical Alerts.

Notifications

iOS: Notifications Settings

❗️

Warning

Due to iOS features beyond our control, Critical Alerts can cause some calls made through third-party communication apps to drop when they’re sent during an ongoing call.

On-Call Boosters

On-Call Boosters provide push notifications about changes to your on-call schedules. You will immediately receive a push notification when:

  • You are added to a schedule
  • You are removed from a schedule
  • Changes are made to your on-call shifts within the next eight weeks (e.g., overrides, reordering)

🚧

Notification Exceptions

Please note that notifications will not be sent if the change was made by the user themselves or if the change was made through the REST API.

This feature is enabled by default for all mobile users. To disable On-Call Boosters, navigate to More in the top right. Slide the toggle for On-Call Boosters off and tap Done.

For iOS devices, these notifications will use your device's Default Alerts (Settings Sounds & Haptics Default Alerts) configuration.

App Tip Notifications

App Tip Notifications are delivered locally through the mobile app, and will occasionally notify you about new features and PagerDuty tips. Disabling this feature will not affect incident-related notifications or other PagerDuty communications, (e.g., status updates, on-call handoff notifications, responder requests, etc.). Since these are local notifications, the setting selection will not be preserved if you uninstall and re-install the PagerDuty mobile app.

Navigate to More . Slide the toggle for App Tip Notification Settings on or off and tap Done.

A screenshot of the iOS PagerDuty mobile app showing how to turn App Tip Notifications on or off

App Tip Notifications toggle

For iOS devices, these notifications will use your device's Default Alerts (Settings Sounds & Haptics Default Alerts) configuration.

Focus Mode

The Focus Mode feature allows users to have granular control over which apps and contacts get to notify them at the given Focus setting (including Do Not Disturb). You can learn more about the Focus feature here.

In order to bypass all Focus modes, you can complete the following:

You can also override a specific Focus.

Override Silent Mode and Focus for Phone Notifications

When you receive a phone notification from PagerDuty, you may want your phone to audibly ring, even while it is on silent or when any Focus mode is enabled.

  1. If you haven't done so already, download PagerDuty's vCard to add PagerDuty Outgoing Numbers to your contacts.
  2. Navigate to your phone's Contacts app and select PagerDuty Outgoing Numbers.
  3. Tap Edit in the top-right, scroll down and select the row Ringtone.
  4. Activate Emergency Bypass and tap Done.
  5. Tap Done again.

Override a Specific Focus

You can allow PagerDuty notifications to override a specific Focus (e.g., Do Not Disturb) via the steps below.

To allow push notifications:

  1. Navigate to your device's Settings Focus and select the desired Focus.
  2. Tap Apps Allow Notifications From.
  3. Tap and select PagerDuty.
  4. Tap Done to save your selection.

To allow phone notifications:

  1. Within the PagerDuty Mobile App, navigate to More in the top right.
  2. If you already had the app installed, select Update PagerDuty Contact Card.
    • If this is your first time logging into the app, you'll be prompted to grant PagerDuty the Manage Contacts permission. You can read about how we use this permission here.
  3. Navigate to your device's Settings Focus and select the desired Focus.
  4. Tap People Allow Notifications From.
  5. Tap the and select the PagerDuty contact, PagerDuty Outgoing Numbers.
  6. Tap Done to save your selection.
Focus mode

Focus mode

Notification Summary

The Notification Summary feature allows non-critical notifications to be received at a specific time of the day to avoid taking away users’ attention during focus time. A few points to take note of with this feature:

  • Notification Summary is optional and disabled by default.
  • If desired, the PagerDuty app will need to be part of the list of chosen apps for the Summary located in Settings Notifications Scheduled Summary.
  • Critical Alerts can still be received instantly.

New PagerDuty app users will receive a prompt upon installing to either allow notifications or include them in a scheduled summary.

Allow notifications

Allow notifications prompt

Notification Preferences

You can quickly update your notification rules for high urgency incidents. We offer three pre-configured options to choose from:

  • Never Miss a Page: Immediately sends a Push notification, followed by an email after one minute, SMS after two minutes, and a call after three minutes.
  • Always Text First: Immediately sends a SMS, followed by an email after one minute and a call and push notification after two minutes.
  • Always Call First: Immediately calls, followed by a SMS after one minute and an email and push notification after two minutes.

You can also click Advanced Notification Rules to set your own preferences.

Appearance

You can adjust various aspects of how the mobile app appears. Navigate to More and tap App Appearance.

To change the in-app color scheme, tap Theme and select from the following options:

  • System
  • Light
  • Dark

To change the app icon, tap Icon and make a selection:

  • Green (default)
  • Blue
  • Cream
  • Pink
  • Sky
  • Yellow

Shared Settings

Troubleshoot Notifications

To receive a test push notification, navigate to More and tap Troubleshooting (Android) or Troubleshoot Notifications (iOS). If the notification is successful, you will receive a push notification based on your settings. If an issue occurs, a prompt will advise you on what settings may need to be adjusted to ensure you receive notifications.

Optionally, tap Run Tests to run troubleshooting tests again.

Support Resources

If you need further assistance, we provide easy access to additional resources in the app's Settings:

  • Community Support: Visit PagerDuty Commons, our community site.
  • Email Support: Tap Email Support to email our Support Team directly.
  • PagerDuty System Status: Check PagerDuty's PagerDuty Status Page and sign up for notifications.

Contact Card Settings

The PagerDuty vCard is a file containing the numbers that PagerDuty notifications can come from. These numbers are saved to the PagerDuty Outgoing Numbers contact. The vCard updates automatically by default in the mobile app, and there is nothing that needs to be configured. Tap Automatic Contact Card Management to manually update the vCard; if prompted, tap Continue to give the PagerDuty app permission to access your contacts.

Live Updating

Live Updating automatically updates the incidents list and incident details screen on your mobile app with the latest information. Tap the Live Updating checkbox (Android) or toggle (iOS) to enable or disable this option. We recommend disabling this option if you are experiencing connectivity issues.