# 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](#configure-android-devices)
- [Configure iOS Devices](#configure-ios-devices)

> **Beta Versions Not Supported:** PagerDuty mobile apps do not support beta versions of iOS or Android. Wait until the official OS release before updating, as beta builds can impact core functionality such as authentication and notifications.

## 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**  →  .
2. Tap **System Notification Settings** and ensure **Allow notifications** is enabled.

![Notification settings](/images/kb/acfa2b99d15156e6e75e99849e788a251f770e14e1ec59bd6b8c63151796b6d2-android-system-notification-settings.webp)

#### High-Urgency Notifications

Tap **High-Urgency Notification Settings** and ensure **Allow notifications** is enabled. Ensure the sound within the High-Urgency Notification Settings is set to **None**. Setting a sound will play two notification sounds and a warning message will be displayed.

![High-Urgency Notification Settings](/images/kb/512b931f20397640eea33f0a026f5d99d33d6cfbe00a13d458a891bc01800568-Untitled_design_12.png)
*Override system volume*

#### 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 Modes:** If you are using Android's Modes feature to enable Do Not Disturb, you must edit the Mode's settings to allow notifications from PagerDuty. Each Mode has its own **Allowed during Do not disturb** list.

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](/images/kb/fa3c4e43f4cc1aad7c4742a6a74c48d2dcaf88ea5e91f9d7f217421b23e62513-android-dnd-settings.webp)

You can confirm this was successfully enabled in the PagerDuty app by navigating to **More**  →  . 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**  →  . 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.

#### App Tip Notifications (Android)

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](/incident-management/notifications/notification-content-and-behavior) or other PagerDuty communications, (e.g., [status updates](/incident-management/communicate/communicate-with-stakeholders#status-updates), [on-call handoff notifications](/account-admin/user-profile/notification-rules#on-call-handoff-notifications), [responder requests](/incident-management/incidents/add-responders#responder-notifications), 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](/images/kb/323f9b746091333ff924f9902be84af4e0b89528fbf18e9866eaecfe7d0c2bcd-android_app_tip_notifications.webp)
*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 (Android)

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**  →    →  **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](/incident-management/communicate/communicate-with-stakeholders#status-updates) and/or [on-call handoff notifications](/account-admin/user-profile/notification-rules#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**  →  .
   - 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](/incident-management/communicate/communicate-with-stakeholders#status-updates) and/or [on-call handoff notifications](/account-admin/user-profile/notification-rules#on-call-handoff-notifications), these notifications will use your device's **Default Alerts** (**Settings**  →  **Sounds & Haptics**  →  **Default Alerts**) configuration.
>
> When you are [added as a Responder](/incident-management/incidents/add-responders) to an incident, the iOS mobile app will always use the **PagerDuty Alert** ringtone for push notifications.

#### Critical Alerts for High-Urgency

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

![Allow Critical Alerts](/images/kb/ad4bfe1cf4dfa3306ea0dab34471b9b1b98a8a680cd2414dfdf18ccd9a321db6-allow_critical_alerts.webp)

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

![Notifications](/images/kb/df6aa00aacee01a94aeb16fe7a7b1a0c7c1df1ebac3d8edcdadbcfedce9a133e-ios_notifications.webp)
*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 (iOS)

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**  →  . 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 (iOS)

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](/incident-management/notifications/notification-content-and-behavior) or other PagerDuty communications, (e.g., [status updates](/incident-management/communicate/communicate-with-stakeholders#status-updates), [on-call handoff notifications](/account-admin/user-profile/notification-rules#on-call-handoff-notifications), [responder requests](/incident-management/incidents/add-responders#responder-notifications), 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](/images/kb/21ce18d7314f37ab33d272ee1fdaa3c8f0c09620282c55e377743eb74ad50308-iOS_app_tip_notifications.webp)
*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](https://support.apple.com/en-us/HT212608).

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

- Enable [Critical Alerts](#critical-alerts-for-high-urgency) for push notifications.
- Activate [Emergency Bypass](#override-silent-mode-and-focus-for-phone-notifications) for the **PagerDuty Outgoing Numbers** contact for phone notifications.

You can also override a [specific Focus](#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](/incident-management/notifications/notification-phone-numbers#pagerduty-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**, 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**  →  .
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](/get-started/mobile-app#mobile-app-permissions).
3. Navigate to your device's **Settings**  →  **Focus** and select the desired Focus.
4. Tap **People**  →  **Allow Notifications From**.
5. Tap  and select the PagerDuty contact, **PagerDuty Outgoing Numbers**.
6. Tap **Done** to save your selection.

![Focus mode](/images/kb/edf86698528c463039540c8b0ca443d02e818b5d7ad4fda585a7364453163a2e-focus_mode.webp)

### 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](/images/kb/5142ca2d9e8580a73639059b1303dcaffff261c0702eb2938e4b109e6ca49728-allow_notifications.webp)
*Allow notifications prompt*

### Notification Preferences

You can quickly update your [notification rules](/account-admin/user-profile/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](https://community.pagerduty.com/), our community site.
- **Email Support**: Tap **Email Support** to email our Support Team directly.
- **PagerDuty System Status**: Check PagerDuty's [PagerDuty Status Page](https://status.pagerduty.com/) and sign up for notifications.

### Contact Card Settings

The [PagerDuty vCard](/incident-management/notifications/notification-phone-numbers#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.
