External Status Page

Inform the public about your infrastructure's health

External Status Pages offer public audiences a unified source of truth about your infrastructure’s health. This feature can be customized to fit your brand’s look and feel, and you can define different views and sets of Business Services to display. Visitors can stay informed about ongoing incidents and read status updates, or subscribe to your status page to receive notifications via email.

📘

Pricing Plan Availability and Packages

  • The External Status Page feature is an add-on that must be paired with an Incident Response or Customer Service plan. Please contact our Sales Team for pricing details or if you would like to upgrade to a plan that includes the External Status Page feature.
  • PagerDuty offers two Status Page packaging options, one which includes public status pages, and a premium package that also features private status pages. Depending on the package you choose, other features items such as Page Subscribers, Premium Account Subscribers and Total Account Subscribers may vary. Please contact our Sales Team for more information.

📘

Looking for our Company Status Page?

This article describes our External Status Page product, which you can use to build your own status pages. If you are looking for more information about the PagerDuty company status page at status.pagerduty.com, please read PagerDuty Outage Notifications.

Create an External Status Page

🚧

Required User Permissions

Users with the following base roles can configure an external status page:

  • Manager
  • Global Admin
  • Account Owner

Users who create an External Status Page become the Page Owner. Page Owners can edit their own status pages or delete their own drafts. Account Owners can edit any status page and delete any draft.

📘

Prerequisites

  • External Status Pages rely on Business Services to automatically alert users when there is a service degradation. After you’ve configured service dependencies, information about impacted business services will appear on the External Status Page.
  • By default, an incident with a priority of P1 or P2 will be considered an "impacting" incident. You can adjust this setting to restrict or include a wider set of incident priorities, depending on your organization's needs.
  • Incident priority is an account-wide setting, and will apply to both Internal Status Pages and External Status Pages. Incident priority can also be configured via the REST API.
  1. In the web app, navigate to Status External Status Page.
  2. Click New Status Page.
  3. Enter a descriptive Name for your status page, and in the Simple URL field, create a unique public subdomain that your users can access.
    • Note: After you've published an external status page, you will have the option to set a Custom URL, which will determine the web address where your status page can be accessed, and will also be used for the sender address when email notifications are sent to status page subscribers. Please see the section Configure DNS Records for more information.
Create a new status page

Create a new status page

❗️

Simple URL

The Simple URL cannot be changed after you have saved or published an external status page. Please take a moment to confirm that you've entered your Simple URL correctly.

  1. Click Next.
  2. In the Criteria section, select the Business Service(s) that you’d like to display on your status page by clicking next to each. Selected business services will be shown in the right column. To deselect them, click . Once you’re ready, click Next.
    • Optional: You can organize business services into groups:
      1. Click Add Group, enter a Group Name and click .
      2. Click and hold next to a business service's name, drag it over the group's name, and release.
      3. Click the expand arrow (e.g., /) to show/hide the business services in a group.
    • Optional: Click Edit Display Names to adjust your business services' public-facing names. This can be useful if you do not wish to disclose internal naming conventions, or to display a name that the public would better understand.
  3. The Permission section allows you to define which teams and user roles can post incident status messages on the status page, which teams can edit the status page, whether posts require approval, and whether you'd like to automate posts when an incident affects a business service. Make your selection in each of the following sections:
SectionInstructions
Teams that can manage the Status PageFrom the dropdown, select which Team(s), besides the original creator, can edit or delete the Status Page.
Create PostSelect which PagerDuty roles can create posts for the External Status Page: Global Admin, Manager, Responder, Observer and/or All of these roles.
Teams that can post to the Status PageSelect which Teams can post new incidents or updates to the status page.
Automated Incident PostsThis toggle (on or off) controls whether an automated post will publish when an incident triggers on an included business service. If approval is required to post messages, the incident will need to be approved before it is posted.
Posts ApprovalSelect Approval is required to post messages or No approval is needed to post messages. If you select Approval is required to post messages, please select up to 5 users from the dropdown; these users will be able to review a draft of the message before it is posted on the status page.
Example status page permissions

Example status page permissions

  1. Click Next.
  2. In the Theme tab of the Customize section, you can set the color palette, and upload your organization's logo and a favicon that will be displayed on the browser tab.
  3. In the Status Page tab, you can optionally add an image to the header and footer, set up a navigation bar, and you can include relevant links to your status page.
    • If you'd like to hide the Subscribe button on the public-facing status page, in the section Navigation Bar Subscribe Button, move the toggle to No.
Customize status page

Customize status page

  1. Click Publish.
  • Optionally, if you’re not ready to publish your status page, click Save as Draft in the bottom-left corner.

Configure DNS Records

After you publish an external status page, you can configure a Custom URL, which will be used for the sender address when email notifications are sent to status page subscribers. PagerDuty will generate a set of DNS records, each of which must be verified with your DNS provider in order for the Custom URL to work as expected.

  1. Navigate to Status External Status Page.
  2. Click next to the desired published status page and select Edit.
  3. In the field Custom URL, enter your desired domain.

❗️

Custom URL

The Custom URL cannot be changed after you have saved or published an external status page. Please take a moment to confirm that you've entered your Custom URL correctly.

If you plan on migrating a custom URL that's currently in use with another status page solution, and you want to decrease downtime, please reach out to us at [email protected].

  1. Click Submit Custom URL.
  2. Using the information in the section DNS Records, add each record in your provider's administration console.
Example DNS records

Example DNS records

Why We Require These Records
  • mail_cname, dkim: Allows PagerDuty to authenticate emails on behalf of your domain.
  • tls-certificate: Allows PagerDuty to issue a TLS certificate for your domain to secure your Status Page with SSL/TLS.
  • http-traffic: Redirects users to the Status Page.
  1. Check the box I’ve added the records to my provider and click Verify Records.
Verify records

Verify records

After successful verification, the tag in the State column will change from Unverified to Verified. Depending on your DNS provider, record validation may take anywhere from a few minutes up to one or more days.

Please refer to your DNS provider's documentation for more information about adding DNS records and troubleshooting.

View the External Status Page

PagerDuty users can view an external status page by navigating to its unique public URL (e.g., https://subdomain.trust.pagerduty.com), or in the PagerDuty web app by navigating to Status External Status Page and selecting a status page's title from the list.

Edit an External Status Page

🚧

Required User Permissions

Only the Page Owner (i.e., the user who created the status page draft), the Account Owner, and members of a Team with edit access can edit a status page.

  1. Navigate to Status External Status Page.
  2. Click next to the desired status page and select Edit.
  3. On the first page you can make changes to your Status Page Name. Click Next at bottom left to continue on to edit Business Services, Permissions and Customize settings.
  4. When ready, click Publish.

Publish a Draft Status Page

  1. Navigate to Status External Status Page.
  2. Click next to the desired status page and select Publish.

View Incidents

You can see ongoing and resolved incidents, as well as pending communication approvals related to each of your External Status Pages.

View incidents

View incidents

  1. Navigate to Status External Status Page.
  2. Click on the status page name.
    a. Use the Ongoing Incidents tab to gain awareness of the incidents that are currently impacting the Business Services related to this External Status Page.
    b. The Resolved Incidents tab will let you see the history of past incidents.
    c. The Pending Approvals tab will display ad-hoc communications that need to be approved in order to be published on your External Status Page.
    d. Click New Incident to manually trigger a new incident in order to manually alert your user base about an issue.

Delete a Status Page

🚧

Required User Permissions

Only the Page Owner (i.e., the user who created the status page draft), the Account Owner, and members of a Team with edit access can delete a status page.

  1. Navigate to Status External Status Page.
  2. Click on the name of the status page that you wish to delete.
  3. Click the button in the sidebar at the left side of the page.
  4. Select Delete Status Page.
  5. Confirm the deletion by typing "delete" in the modal window and clicking the Yes, delete button.

Status Page Incidents

Status Page Incidents are different from the regular incidents that you or your monitoring tools may trigger on technical services. Status Page Incidents are bound to the status page only and are meant to be used to publish status updates and inform your external audience of the current status of an internal incident.

🚧

Requirement

In order to post Status Page Incidents, incident Priority (an account-level setting) must be enabled.

Status Page Incidents

Status Page Incidents

Create a Status Page Incident

  1. Navigate to Status External Status Page.
  2. Click on the name of the desired status page.
  3. Click + New Incident.
  4. Select the incident status: Detected, Investigating, or Resolved.
  5. Give the Status Page Incident a descriptive Title and write an initial Message for External Status Page subscribers and visitors. The Message field supports rich text, including hyperlinks. To add a hyperlink to a message, highlight the text your preferred text, then right-click and click Link, to fill out the URL and other information.
  6. Select the Impacted Business Services.
  7. Select the level of impact: All Good, Major, or Minor.
  8. Optional: Let users know the estimated Time till Next Update.
  9. Optional: Check the Send update notifications to subscribers checkbox to send notifications.
  10. Click Post to post the incident.
Create a Status Page Incident

Create a Status Page Incident

Publish a Status Update

To publish a new status update you’ll need to have an open Status Page Incident or a regular incident that is impacting a Business Service.

  1. Navigate to Status External Status Page.
  2. Click on the name of the desired status page.
  3. In the open incidents list, click the to the right of the desired incident and select Post New Update.
  4. Select the Incident Status.
  5. Write a Message for your External Status Page subscribers and visitors.
  6. Select the Impacted Business Services.
  7. Select the level of impact: All Good, Major, or Minor.
  8. Optional: Let users know the estimated Time till Next Update.
  9. Optional: Check the Send update notifications to subscribers checkbox to send notifications.
  10. Click Update to publish the status update.
Publish a status update

Publish a status update

Approve a Status Update

When a status update requires approval, named approvers will receive an email notification, a banner will appear on a status page's Incidents screen, and the Pending Approvals tab will also indicate that there are updates that need review.

Pending status updates banner

Pending status updates banner

Users with appropriate permissions can approve pending status updates in the web app:

  1. Navigate to Status External Status Page.
  2. Click on the name of the desired status page.
  3. Select the Pending Approvals tab.
  4. Click next to the status update and select Review Post.
  5. Review the details of the status update and click Publish.

Reject a Status Update

While following the approval steps above, you also have the option to Reject a status update. Click Reject and confirm your decision in the modal by clicking Yes, delete.

🚧

Rejected Status Updates

Rejected status updates cannot be retrieved, and this action cannot be undone.

Reject a status update

Reject a status update

Edit a Status Update

Your users can add information or make changes to existing status updates.

  1. Navigate to Status External Status Page.
  2. Click on the name of the desired status page.
  3. In the open incidents list, click next to the desired incident and select View Timeline & Edit.
  4. Locate the status update that you need to update and click next to it. Make the necessary changes and click Update.
  5. If you need to edit the impacted services, click icon under Business Services Impacted, select the desired business services, and then click Update.

Add a Postmortem to a Status Page

You can add public postmortems to any resolved External Status Page incident to share with your customers.

To add a postmortem to a resolved External Status Page incident:

  1. Navigate to Status External Status Page and then select your preferred status page.
  2. You will be directed to the Posts Incidents page by default. Select the Resolved tab, click the menu to the right of the incident, and then select Add Postmortem.
  3. Enter your postmortem in the Message field. You may use the text formatting options above to format your postmortem message.
  4. Once you are finished entering your postmortem message, under Notifications you may optionally select the checkbox to Send update notifications to subscribers.
  5. Please note that once posted, postmortems will be published immediately, independent of any configured approval flow you may have for your page. When you are sure that you would like to proceed, click Post.

Edit an External Status Page Postmortem

To edit a External Status Page postmortem that has already been posted:

  1. Navigate to Status External Status Page and then select your preferred status page.
  2. You will be directed to the Posts Incidents page by default. Select the Resolved tab, click the menu to the right of the incident and then select Edit Postmortem.
  3. Edit the postmortem in the Message field. You may use the text formatting options above to format your postmortem message.
  4. Once you are finished editing your postmortem message, under Notifications you may optionally select the checkbox to Send update notifications to subscribers.
  5. Please note that once posted, postmortems will be published immediately, independent of any configured approval flow you may have for your page. When you are sure that you would like to proceed, click Update.

Delete an External Status Page Postmortem

To delete a External Status Page postmortem that has already been posted:

  1. Navigate to Status External Status Page and then select your preferred status page.
  2. You will be directed to the Posts Incidents page by default. Select the Resolved tab, click the menu to the right of the incident and then select Edit Postmortem.
  3. At the bottom right, click Delete. A confirmation modal will appear, notifying you that this action cannot be undone and that subscribers are not notified of deleted posts. When you are ready to proceed, click Delete again.

Scheduled Maintenance Notices

You may let your users know about upcoming or ongoing maintenance windows for any components of your application or infrastructure. The external status page allows you to schedule maintenance notices, select the affected business services, and post updates.

Post a Maintenance Notice

  1. Navigate to Status External Status Page.
  2. Click on the name of the desired status page.
  3. On the left sidebar, select Maintenance under Posts.
  4. Click Post New Maintenance.
  5. Select the maintenance status: Scheduled, In Progress, or Completed.
  6. Write a Title for your notice and a Message describing the maintenance. Visitors and subscribers will see this text.
  7. In the section Scheduled Maintenance Time, use the date and time pickers to select start and end times.
  8. Select the Impacted Business Service(s).
  9. In the Notifications section, check or uncheck the box depending on whether you'd like to notify subscribers about the maintenance.
  10. Click Post.
New maintenance notice submission form

New maintenance notice submission form

Post a Maintenance Update

  1. Navigate to Status External Status Page.
  2. Click on the name of the desired status page.
  3. On the left sidebar, select Maintenance under Posts.
  4. Click next to the desired maintenance notice and select Post New Update
Post new maintenance update

Post new maintenance update

  1. Select the Maintenance Status and write an update in the Message field.
  2. Select the impacted Business Services.
  3. Click Post.

End a Maintenance Window Early

  1. Navigate to Status External Status Page.
  2. Click on the name of the desired status page.
  3. On the left sidebar, select Maintenance under Posts.
  4. Click next to the desired maintenance notice and select Post New Update
  5. Under Maintenance Status, select Completed.
  6. Post the update. The maintenance will be moved to the Completed tab.
Completed maintenance windows

Completed maintenance windows

Delete a Maintenance Notice

  1. Navigate to Status External Status Page.
  2. Click on the name of the desired status page.
  3. On the left sidebar, select Maintenance under Posts.
  4. Click next to the desired maintenance notice and select Delete
  5. Confirm the action by clicking the Yes, delete button. Deleted maintenance notices cannot be restored.

Subscribe to Status Updates

There are multiple ways you or other users can subscribe to status updates:

In the Subscriber Console

You can subscribe yourself or another user to receive status updates via email.

  1. In the web app, navigate to Status External Status Page.
  2. To the right of your desired status page, click Subscribers.
Select "Subscribers"

Select "Subscribers"

  1. Click Add Subscriber.
  2. In the modal, enter a user's email address and select Status Page or Business Services.
    • If you select Status Page, the user with be notified for all incidents and updates to this status page.
    • If you select Business Services, please enter one or more Business Services. This option only notifies the user when there is a status page update related to their selected business service(s).
Subscribe a user to a business service

Subscribe a user to a business service

  1. Click Add.

Subscribed users will receive an email notification whenever there is an incident on the status page or their selected business services.

Example email notification

Example email notification

Import Subscribers from a CSV File

📘

Notification Method

The Import Subscribers feature only supports email subscriptions at this time.

  1. In the web app, navigate to Status External Status Page and select your preferred status page's name.
  2. In the left pane, click Subscribers.
  3. To the right of Add Subscriber, click Import Subscribers (CSV).
Select Import Subscribers

Select Import Subscribers

  1. In the modal, download the CSV Template (PD-import-subscribers-template.csv), and then add your subscribers' email addresses to the file.
    1. Note: The file type must be CSV, and a maximum of 5000 rows is allowed.
Downland CSV template

Downland CSV template

  1. In the section CSV File, click Browse and select the file with your subscribers' email addresses.
  2. Select Status Page to notify users whenever there is a post or update on the status page, or Business Service to only notify when a specific business service is affected.
    1. If you select Business Service, a section Subscribe to a Service will appear. Select your preferred business service. Note: Only the business service(s) that you selected while configuring the status page will appear in this section.
  3. Optional: Check the box Send subscription consent emails if you'd like users to receive a confirmation email. They will need to confirm their subscription before they begin receiving status updates.
  4. Click Import.

On the Public-Facing Status Page

You can also subscribe to a status page from its public URL.

  1. Visit a status page's public URL, e.g., https://status.pagerduty.com/.
  2. In the top-right, click Subscribe to Updates.
  3. In the modal, enter your email address and select which business services you'd like to be notified for. To receive notifications for all incidents on this status page, leave the default selection, All Services.
  4. Click Subscribe.
Subscribe on the public-facing status page

Subscribe on the public-facing status page

  1. You should receive a confirmation email; open it and click Confirm your subscription.
  2. On the following page, click Yes, subscribe.

Slack Subscriptions

A status page administrator can enable Slack subscriptions so that end users can receive status updates in Slack.

Enable Slack Subscriptions

  1. In web app, navigate to Status External Status Page.
  2. To the right of your desired status page, click Edit.
  3. Under step 4 Customize, select the Status Page tab.
Edit External Status Page

Edit External Status Page

  1. Under Select the subscription method(s) shown on the Status Page, select Slack .
Select "Slack"

Select "Slack"

  1. Click Save.

Subscribe via Slack

  1. In you web browser, navigate to a status pages public URL and click Subscribe Updates in the top-right.
  2. Select the Slack tab and click Add to Slack.
Add to Slack

Add to Slack

  1. If you have administrative permissions to add apps to your Slack workspace, select a channel from the dropdown and click Allow to authorize your workspace. If you do not have administrative permissions, you can add a message for your App Managers and click Submit to send the installation request to your organization's Slack admins.
    • Note: If you are part of more than one Slack workspace, you can select the appropriate workspace from the dropdown in the top-right.
Connect Slack workspace

Connect Slack workspace

Request to install

Request to install

  1. After successful installation, you will receive a Slack message in the connected channel: added an integration to this channel: PagerDuty Status Pages.

Now, whenever there is a post on the status page, you'll receive an update in Slack, too.

Slack Status Update

Slack Status Update

Webhook Subscriptions

A status page administrator can enable webhook subscriptions so that end users can receive a webhook when there is a status update.

Enable Webhook Subscriptions

  1. In web app, navigate to Status External Status Page.
  2. To the right of your desired status page, click Edit.
  3. Under step 4 Customize, select the Status Page tab.
  4. Under Select the subscription method(s) shown on the Status Page, select Webhook .
Select "Webhook"

Select "Webhook"

  1. Click Save.

Subscribe via Webhooks

  1. Navigate to an external status page's public-facing site.
  2. In the top-right, click Subscribe to Updates.
  3. Select the tab Webhook and enter your webhook's URL in the field Webhook URL. Optionally enter an email address; we will send an notification to this email address if there are issues delivering the webhook.
  4. Click Subscribe Webhook.

Example Payload

{
  "ends_at": null,
  "href": "https://subdomain.trust.pagerduty.com/incident_details/PXXXXXX",
  "message": "We are currently working on the issue.",
  "next_update_ms": 900000,
  "post_type": "incident",
  "reported_at": "2023-05-15T20:47:12Z",
  "services": [
    {
      "service_name": "Checkout",
      "severity": "minor"
    }
  ],
  "severity": "minor",
  "starts_at": null,
  "status": "investigating",
  "status_page": "Acme Corp",
  "title": "Checkout is temporarily unavailable"
}
{
        status_page: <string>,
        post_type: <incident | maintenance>,
        title: <string>,
        starts_at: <datetime | null>,
        ends_at: <datetime | null>,
        reported_at: <datetime>,
        message: <string>,
        href: <url>,
        status: <detected | investigating | resolved | scheduled | in_progress | completed>,
        severity: <minor | major | all_good | maintenance>,
        services: <listOf(<object({ service_name: <string>, severity: <minor | major | all_good | maintenance>})>)>,
        next_update_ms: <integer>
}

Unsubscribe from Status Updates

In the Subscriber Console

As an admin, you may wish to unsubscribe a user from a status page.

  1. Navigate to Status External Status Page.
  2. To the right of your desired status page, select Subscribers.
  3. To the right of the desired users, select Delete.
  4. Read the warning modal and click Yes, delete.

In a Status Update Email

Users can unsubscribe themselves from a status page using a link in an email notification.

  1. Open an email related to a status page update and click Manage your subscription at the bottom.
  2. Click Yes, unsubscribe.

Disconnect Slack Connection

If you'd like to stop receiving status updates in Slack, please refer to Slack's documentation about how to Remove apps and custom integrations from your workspace.

Unsubscribe a Webhook

As an admin, you can unsubscribe a webhook from a status page.

  1. Navigate to Status External Status Page.
  2. To the right of your desired status page, select Subscribers.
  3. Select the tab Webhook click to the right of the desired webhook URL Delete.
  4. Read the warning modal and click Yes, delete.

Note: This action cannot be undone. Users will not receive a notice that the webhook was unsubscribed.

Status Page Templates

Use status page templates to create preset posts that can be selected during an incident or maintenance.

Create a Status Page Template

  1. Navigate to Status External Status Page select your preferred Status Page Posts Templates and then click New Template.

Create a status page template

Create a status page template

  1. Perform the following:
FieldInstruction
Post TypeSelect the type of post you would like to create a template for: Incident or Maintenance.
Template NameEnter a template name.
DescriptionEnter an optional template description.
Incident or Maintenance StatusDepending on the post type selected above, you will see either Incident Status or Maintenance Status. Select your post's status from the dropdown.
TitleEnter an optional title for the post.
MessageEnter the post message.
Impacted Business ServicesSearch and select impacted business services by checking the checkbox to the left of the business service. If you have selected an Incident post type, select the outage status in the dropdown to the right.
Impact

(Incident Post Type Only)
Select the incident impact level. This will determine the status level on your page.
Time till Next Update

(Incident Post Type Only)
Select the time duration until the next status update.
NotificationsCheck this checkbox if you would like status update notifications to be sent to subscribers.
  1. Once you have finished entering your preferred settings, click Create Template.

Edit or Delete a Status Page Template

  1. Navigate to Status External Status Page select your preferred Status Page Posts Templates.
  2. Click to the right of your template and select from the following:
  • Edit Template: Edit your preferred details and then click Save.
  • Delete: A modal will appear to let you know that this action cannot be undone once deleted. If you wish to proceed, click Yes, delete.

Apply a Status Page Template

Apply a status page template to populate a post with preset values. Templates can be used with new posts and post updates.

  1. Navigate to Status External Status Page select your preferred Status Page select Posts.
  2. Perform the following depending on your use case:
  • New Post: Click Post New Incident. On the next screen, click Apply Template and then select your preferred template from the dropdown. Your template will automatically apply to all of its preset fields. You may make edits after applying the template, or you can leave it as is. Click Post to post your incident.
  • Post Update: Select the menu to the right of your preferred incident and select Post Update. On the next screen, click Apply Template and then select your preferred template from the dropdown. Your template will automatically apply to all of its preset fields. You may make edits after applying the template, or you can leave it as is. Click Update to post your update.
New post

New post

FAQ

Who will be able to access the status page externally?

Expand

Once you publish an external status page, any end-user will be able to access it at its public URL.

Can I customize my public URL?

Expand

Yes, you can customize the public URL while creating or editing a status page.

What is a subscriber?

Expand

A subscriber is any user on the internet that has opted in to receive communications about incidents in your External Status Page.

How can I customize my page layout?

Expand

You can customize the layout of your External Status Page during the Customize step while creating or editing a status page.

Does the external status page support rich text and hyperlinks?

Expand

Yes. The external status page supports rich text and hyperlinks for incidents, maintenance posts, templates, and postmortems. To add a hyperlink, right-click on the text and select Link... Enter the URL in the modal and click Save.