Account Subdomains

Change your account's subdomain

PagerDuty accounts are accessible via a personalized subdomain. For example, if your company name is EveryNine Inc., you can set your account's subdomain to everynine.pagerduty.com, e9inc.pagerduty.com, or anything else provided that it is five or more characters long and it is not already in use. Your account's subdomain is initially configured during trial activation. Once configured, your account's subdomain will then prepend your account's URL:

[YOUR-SUBDOMAIN].pagerduty.com

If you need to change your account's subdomain from the one initially configured, you will need to perform the following:

📘

Availability

Changing the account subdomain is available for Professional, Business, Enterprise for Incident Management and Digital Operations (Legacy) plans. Accounts on our Free plan are not eligible for changing their subdomain. Please contact our Sales team to upgrade your account or visit our Pricing page for more details on each of our plans.

Prepare to Change Your Subdomain

When changing subdomains, please be mindful of the following:

  • Integration email addresses for your PagerDuty services will change.
  • Users will not be notified by PagerDuty of the subdomain change. You will need to communicate the change to your team so they know when and why the old subdomain will no longer be accessible.
  • Although push notifications can still be received, the mobile app will not load and users will need to log out and log back into the mobile app.
    • Please see Using the Mobile App for more information about logging in and out of the PagerDuty app.
    • If these steps don't work, you can reset the app in your device settings:
      • iOS: Settings PagerDuty Reset .
      • Android: Settings Applications PagerDuty Clear Cache.
  • If you have Single Sign On enabled, you will need to adjust your identity provider settings to reflect your new PagerDuty subdomain.
  • If you are using the bidirectional MS Teams integration, you will need to uninstall and reinstall the Microsoft Teams integration.
  • There is a minimum of five characters for PagerDuty subdomains.

Recommended Preparation Steps

To prevent any interruption in responders being able to act on their incidents, we recommend using the following action plan before changing your subdomain.

ActionAdditional Information
Notify users about the upcoming subdomain changeSample email template provided
Add new email integration addresses in existing integrations Recommended to limit impact on alerting

Otherwise, existing email integration addresses can be swapped with new ones after the subdomain change. (NOTE: Any emails sent to email
integration addresses with the old subdomain will not trigger incidents
after the subdomain change is complete.)
Remove old email integration addresses or add new onesIf new email integration addresses were added prior to the subdomain change, remove old email integration addresses from existing integrations for security.
Change V1 REST API URL endpoints (Decommissioned October 2018)Any existing scripts hosting v1 REST API URL endpoints need to reflect the new subdomain.
Change SAML endpoint URLIf SSO is configured, adjust your SAML Endpoint URL to reflect the new subdomain.

Sample Email Communication

Sample Email: Preparation for Subdomain Change

Hi Team,

On MM/DD/YY at HH:MM AM/PM PDT, our PagerDuty subdomain will be changed from xxxx.pagerduty.com to yyyy.pagerduty.com. This means that our email integration addresses will change. We will be working on making these adjustments to our existing integrations and scripts.

Please note that after the subdomain change, you will still receive push notifications for your incidents, however you will need to log out and log back into the mobile app to view and take action on incidents. You will also need to use yyyy.pagerduty.com to log in to the web app after the subdomain change, as xxxx.pagerduty.com will no longer be accessible.

To log out of the mobile app:

  • iOS: Tap the menu icon and go to Accounts, tap Edit, then tap the remove icon next to the account.
  • Android: Tap the menu icon and go to Accounts, tap the options icon next to the account, then tap Remove this Account.

If these steps don't work, you can reset the app in your device settings:

  • iOS: Settings → PagerDuty → Reset switch to ON position
  • Android: Settings → Applications → PagerDuty → Clear Cache

Please plan on logging out and logging back in to the mobile app immediately after MM/DD/YY at HH:MM AM/PM PDT to ensure that you can view and take action on your incidents via the mobile app.

Please let us know if you have any questions.

Sample Email: After Subdomain Change is Complete

Hi Team,

This is an update that the subdomain change has been completed.

As a reminder, you must log out and log back in to the mobile app to view and take action on incidents via the mobile app. You must also access yyyy.pagerduty.com to go to the web app.

To log out of the mobile app:

  • iOS: Tap the menu icon and go to Accounts, tap Edit, then tap the remove icon next to the account.
  • Android: Tap the menu icon and go to Accounts, tap the options icon next to the account, then tap Remove this Account.

If these steps don't work, you can reset the app in your device settings:

  • iOS: Settings → PagerDuty → Reset switch to ON position
  • Android: Settings → Applications → PagerDuty → Clear Cache

Change Your Subdomain

Once you have performed the necessary preparation and you are ready to change your subdomain, please contact our Support team. A support agent can coordinate a date and time to change your subdomain for you. The change will be effective immediately.