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

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.

🚧

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.

Create an External Status Page

📘

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 be used for sender address when email notifications are sent to status page subscribers. Please see the section Configure DNS Records for more information.
2360

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 press enter.
      2. Click and hold next to a business service's name, drag it over the group's name, and release.
      3. Press 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 Permissions section allows you to define which user roles can post incident status messages on the status page, whether status messages 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
Create Incident MessageSelect which PagerDuty roles can create incident message 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.
Status Messages 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.
Automated Post SettingsThis toggle (on or off) controls whether an automated post will publish when an incident triggers on an included business service.
2312

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 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.
1118

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.

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

Example DNS records

  1. Check the box I’ve added the records to my provider and click Verify Records.
1200

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) and the Account Owner can edit a status page.

  1. Navigate to Status External Status Page.
  2. Click next to the desired status page and select Edit.
  3. Make the desired changes to your External Status Page's name, URL, business services, permissions, layout, and design.
  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) and the Account Owner can delete a draft.

  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.

1135

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.
  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 for your next update.
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 ellipsis button next to the desired incident and select Post New Update.
  4. Write a message for your External Status Page subscribers and visitors.
  5. Select the incident status and the business service(s) it impacts.
  6. Optional: Select the level of impact and the estimated time for your next update.
1128

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.

1768

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.

1500

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.

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.
1029

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).
745

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.

490

Example email notification

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-page.trust.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.
527

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

Unsubscribe from Status Updates

There are three places to unsubscribe from a status page:

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.

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.

  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.

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.