# 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. You can customize this feature to fit your brand’s look and feel, and define different views and sets of [Business Services](/incident-management/services/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, Slack, or webhook. > **Availability:** External Status Pages are available on all plans and can be extended to include Private/Audience-specific pages or more subscribers with the add-on. Professional plans include one public page, and Business plans include one public and one private status page. > > Please contact our [Sales Team](https://www.pagerduty.com/contact-sales/) for pricing details, or if you would like to upgrade to the status page add-on. > > PagerDuty offers two Status Page packaging add-on options, one which includes Public Status Pages, and a premium package that also features [Private Status Pages](/incident-management/communicate/external-status-page/private-status-page) and [Audience-Specific Status Pages](/incident-management/communicate/external-status-page/private-status-page#audience-specific-status-page). Depending on the package you choose, features such as Page Subscribers, Premium Account Subscribers, and Total Account Subscribers may vary. > > | Pricing Plan | Subscribers | > | :----------- | :---------- | > | Professional | 250 | > | Business | 500 | > | Enterprise | 1000 | > > Please contact our [Sales Team](https://www.pagerduty.com/contact-sales/) for more information. > **Product Limits:** The number of status pages (public external page plus private external page) in an account cannot exceed the limit of 100.
The number of business services associated to an external status page cannot exceed the limit of 500. > **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](https://status.pagerduty.com/), please read [PagerDuty Outage Notifications](/get-started/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](#edit-an-external-status-page) their own status pages or [delete](#delete-a-draft-status-page) their own drafts. Account Owners can edit any status page and delete any draft. > **Prerequisites and Product Limits:** - External Status Pages rely on [Business Services](/incident-management/services/business-services) to automatically notify users when there is a service degradation. After you have configured [service dependencies](/incident-management/services/business-services#supporting-services), information about impacted business services will appear on the External Status Page. > - By default, an incident with a [priority](/incident-management/incidents/incident-priority) of **P1** or **P2** will be considered an "impacting" incident. You can [adjust this setting](/incident-management/services/business-services#edit-business-services-settings) 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](/incident-management/communicate/internal-status-page) and External Status Pages. Incident priority can also be configured via the [REST API](/developer/api/reference/rest/business-services/put-business-service-priority-thresholds). > - You can create up to **100** status pages. 1. In the PagerDuty web app, navigate to **Status** → **External Status Page**. 2. Click **New Status Page**. 3. In the section **Status Page Type**, make a selection: **Public** or **Private**. 1. **Note**: Depending on the features in your account, this option may not be available. 4. Enter a descriptive **Name** for your status page. 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](#configure-dns-records) for more information. ![A screenshot of the PagerDuty web app prompting a user to enter a name and simple URL for an External Status Page](/images/kb/300987eb06cb75a4546c26777a26cf1e270dd3eda8165ff681783a5bd4315fc6-external_status_page.png) *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. 5. Click **Next**. 6. In the **Business Services** section, select the [Business Services](/incident-management/services/business-services) 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 . You can add up to 500 business services per status page. 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. 7. The **Permissions** section allows you to define which [Teams](/account-admin/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: | Section | Instructions | | :------------------------------------- | :--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | Teams that can manage the Status Page | From the dropdown, select which **Team(s)**, besides the original creator, can edit or delete the Status Page. | | Create Post | Select which PagerDuty [base roles](/account-admin/advanced-permissions#base-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 Page | Select which [Teams](/account-admin/teams) can post new incidents or updates to the status page. | | Automated Incident Posts | This enables whether an automated status page post is published when the status of an incident changes (triggered, acknowledged, resolved) on an included business service. If approval is required to post messages, the incident will need to be approved before it is posted. **Note**: If enabled, this option will override the [Post to External Status Page](/workflow-actions/pagerduty-incident-management/post-to-external-status-page) incident workflow action for that status page. In this case, the incident workflow action will not run. | | Posts Approval | Select **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 15 users from the dropdown; these users will be able to [review a draft of the message](#approve-a-status-update) before it is posted on the status page. | ![Example status page permissions](/images/kb/7b9569a2b9ec067554123d36d3b249a527cf1efcc51967f3697a3502939d932d-05bae5f-external-status-page-permissions.webp) *Example status page permissions* 7. Click **Next**. 8. 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. 9. 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](/images/kb/5b11dbaee4a5d8395a5016c84aa10acd344419178e8419d40d9564d6ca69c414-customize_status_page_1.webp) *Customize status page* 10. 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. 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 [support@pagerduty.com](mailto:support@pagerduty.com). 4. Click **Submit Custom URL**. 5. Using the information in the section **DNS Records**, add each record in your provider's administration console. ![Example DNS records](/images/kb/5ed6ff7f541d2d38b539aab166183406a587669eaec0b687980d64dd0af67853-31f7df5-dns.webp) *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. 6. Check the box **I’ve added the records to my provider** and click **Verify Records**. ![Verify records](/images/kb/cb8b4ad535e7cf9ed61e49fe475923eeeda103a7ee6eae44aa911439d4c11b79-ab08643-Verify_records.webp) *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 an 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](/images/kb/3deca8b3355682e22818cbd9b410896d9a9e968ac456432c50a76321f2d241a7-3684124-Screenshot_2023-04-11_at_07.20.43.webp) *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](#approve-a-status-update) in order to be published on your External Status Page.
d. Click **New Incident** to manually trigger a new incident in order to notify your user base about an issue. ### Configure an External Status Page You can customize the metrics display on your status page. The status page uptime metrics calculation is based on major and minor outages, and their durations. Maintenance windows are reflected in the metrics but are not included in the uptime calculation. 1. Navigate to **Status** → **External Status Page** and select your preferred status page. 2. In the left pane, click next to **Configuration** and select **Metrics**. 3. From the dropdown, select your preferred **time period** to preview status page metrics. 1. **Don't display** (default) 2. **Last 90 days** 3. **Last 30 days** 4. **Last 7 days** 4. Click **Save**. ![A screenshot of external status page metrics](/images/kb/e63e582d7ba4a84a89137a0c20a16384197a86e2f40ea2ca180d4cd9db78a116-b6ceea38eadab36addea47af34a5adfe876af3ed3216f1dbc5fb5bc9f6491dd9-external_status_page_metrics.webp) *External status page metrics*
The uptime percentage is calculated based on the duration of partial or significant outage incidents on the external status page. For example, using the last 90 days option, if an incident occurred and lasted 1 hour, we would have 2159 hours of uptime out of 2160 total hours. This would equal 99.9% of uptime. In other words: _Hours of uptime Total hours 100 = Uptime percentage_ The number of bars will adapt to the screen size with each bar representing a specific timeframe. For example, a 13” screen display would show the following for the available time periods: - For 90 days, each bar represents 2 days. - For 30 days, each bar represents 1 day. - For 7 days, each bar represents roughly 4 hours and 20 minutes. ### Delete 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 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 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 click **Delete**. ## Status Page Incidents Status Page Incidents are different from other [Incidents](/incident-management/incidents/overview) 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. > **Prerequisite:** In order to post Status Page Incidents, incident [Priority](/incident-management/incidents/incident-priority), an account-level setting, must be enabled. ![Status Page Incidents](/images/kb/c12c970d65843ee0bd9ee4352dfde404a43969ef8ebaa15d8122ad292588ba1d-3f1f17f-image8.webp) *Status Page Incidents* > **Post Limits:** - Posts have a character limit of 5000 characters. > > - You can have a maximum of 500 ongoing posts per status page. This includes both incident and maintenance posts. > > - You can create up to 1000 posts per status page per month. ### 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: 1. **Detected**: We've identified an issue and it's under investigation. 2. **Investigating**: The incident is still under investigation, and efforts to resolve it are underway. 3. **Resolved**: We've resolved the incident and resumed normal operations. 1. **For Automated Incidents**: 2. **Detected**: Maps to the **Triggered** status of the linked technical incident. 3. **Investigating**: Maps to the **Acknowledged** status of the linked technical incident. 4. **Resolved**: Maps to the **Resolved** status of the linked technical incident. 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.
**Optional**: Set the Incident start time to reflect when impact began. You can backdate the start time so the public timeline matches the actual impact window with the Published Time field 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](/images/kb/ccba1c22872dc9efba5c737c4d2dce98d6b843f9611a499ee3331b1a60ec1eda-5d1acb0-Screenshot_2023-10-24_at_10.56.55_AM.webp) *Create a Status Page Incident* **Note**: External Status Pages refresh automatically when new posts or updates are published. No manual reload is required.
### Publish a Status Update To publish a new status update you’ll need to have an open [Status Page Incident](#create-a-status-page-incident) or a regular [incident](/incident-management/incidents/overview) that is impacting a [Business Service](/incident-management/services/business-services). > **Status Update Limit:** You can add up to 50 status updates per post. 1. Navigate to **Status** → **External Status Page**. 2. Click on the **name** of the desired status page. 3. In the open incidents list, click to the right of the desired incident and select **New Update**. 4. Select the **Post 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](/images/kb/9026fbfe21c6244a8479617cc656d85339dbaa13ba8671eb45302355c12f2bec-f8d4ad5-image5.webp) *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](/images/kb/fed9c0a26612096c9a8aa28d3afe8286dd2fad0b68df7f844714e85b7ccc3a5b-8e26ea9-Pending_approvals_banner.webp) *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](#approve-a-status-update), 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](/images/kb/9f6609baadb8449f2c4408cd0b0da55c1568b1a6f4cc19ac8cbe518e0fe92ea8-c135611-Reject_status_update.webp) *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 **Edit Timeline**. 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 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 an 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 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 an 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 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 Limits:** You can have a maximum of 500 ongoing posts per status page. This includes both incident and maintenance posts. ### 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 Maintenance**. 5. Select the **Post 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](/images/kb/3b4e4bdcd54fbe268090651d3e4c4a82c5a8baec53d3a7c686d0a384bdbac95a-68f8605-Screenshot_2023-04-11_at_08.32.32.webp) *New maintenance notice submission form* ### Post a Maintenance Update > **Status Update Limit:** You can add up to 50 status updates per post. 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](/images/kb/2b166f3f014623a8bc40cb3110397c25f8b544526b9c4d5fdf9481d7d8c9aa4f-52e2152-Screenshot_2023-04-11_at_08.31.16.webp) *Post new maintenance update* 5. Select the Maintenance Status and write an update in the Message field. 6. Select the impacted Business Services. 7. Click **Post**. ### End a Maintenance Window 1. Navigate to **Status** → **External Status Page**. 2. Click on the **name** of the desired status page. 3. 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 moves to the **Completed** tab. ![Completed maintenance windows](/images/kb/d7ff4f369a6eb0f5a45e13e4edfaf61a099db098aa2f302a65d082ffcd9baf01-6f78ac9-Screenshot_2023-04-11_at_08.38.56.webp) *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 **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](#in-the-subscriber-console) - [On the Public-Facing Status Page](#on-the-public-facing-status-page) - [Slack Subscriptions](#slack-subscriptions) - [Webhook Subscriptions](#webhook-subscriptions) ### 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**. 3. Click **Add Subscriber**. 4. In the modal, enter a user's **email address** and select **Status Page** or **Business Services**. - If you select **Status Page**, the user will be notified for all incidents and updates to this status page. - If you select **Business Services**, please enter one or more [Business Services](/incident-management/services/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](/images/kb/c421eb5a628731279f97c556d5e8313f9b1202de4dee1638e3b5b6172b80ae3c-e61ff0e-subscribe_to_business_service.webp) *Subscribe a user to a business service* 5. 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](/images/kb/3c02c3ca7c89aa23c2a2e0ce0920f52a1823320b73f84174cbb21650f817b63d-32284fc-example_email_notification.webp) *Example email notification* > **Subscriber Count:** To view the number of subscribers, navigate to your preferred status page and select **Subscribers** in the left menu. **Page Subscribers** indicates how many users are subscribed to the currently selected status page, while **Total Account Subscribers** shows how many users are subscribed to _all_ status pages. > > ![Status page subscribers](/images/kb/ca56c8c75b4ed6959fbd3d046172cb35793d35c75800cb65d726bdd0f47fcbc3-2f0256b-number_of_subscribers.webp) *Status page subscribers* > > If you reach the maximum number of subscribers, the option to add subscribers will be disabled. Please contact our [Sales Team](https://www.pagerduty.com/contact-us/#contact-sales) to purchase additional status page subscriber licenses. > > You can have a maximum number of 150,000 subscriptions per status page. This includes all email, Slack and webhook subscription channels. #### 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](/images/kb/4349f819e09a685c29bf5fff2692bef86de9027a1d5aeb76b942b1812c2ebcbc-8994f12-download_subscribers_csv_file.webp) *Select Import Subscribers* 4. 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](/images/kb/d5790fe38d2af0dad96d4a6d9b4f259e82897b28f0470132fe55896fa118e648-1b435ca-import_subscribers.webp) *Downland CSV template* 5. In the section **CSV File**, click **Browse** and select the file with your subscribers' email addresses. 6. 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](/incident-management/services/business-services) 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](#create-an-external-status-page) will appear in this section. 7. _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. 8. 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](/images/kb/27efc396cf708405fd5310d3a2a52efae2134324e353fdcaeb548bf0c28ac767-681f17d-subscribe_on_the_public_status_page.webp) *Subscribe on the public-facing status page* 5. You should receive a confirmation email; open it and click **Confirm your subscription**. 6. On the following page, click **Yes, subscribe**. ### Slack Subscriptions A status page administrator can [enable Slack subscriptions](#enable-slack-subscriptions) so that end users can [receive status updates in Slack](#subscribe-via-slack). #### Enable Slack Subscriptions 1. In the 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](/images/kb/27e81347099712f4af5cd631e7fdac86422502212cc935301e6be1b4bf099504-26ca8bd-small-edit-page.webp) *Edit External Status Page* 4. Under **Select the subscription method(s) shown on the Status Page**, select **Slack** . ![Select "Slack"](/images/kb/290141552efcdde8f96c5800231d8170cac2493681dad356e88d0086aa380d6a-2990b9e-small-Select_Slack.webp) *Select "Slack"* 5. Click **Save**. #### Subscribe via Slack 1. In your web browser, navigate to the status page's public URL and click **Subscribe to Updates** in the top-right. 2. Select the **Slack** tab and click **Add to Slack**. ![The Add to Slack button](/images/kb/550f6fd28cbf3379828c73880e89548dbe4f8de14ffd956e22f0167620087374-1152911-small-add-to-slack.webp) *Add to Slack* 3. 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](/images/kb/b010ac88b0bed939c66b989bb05cd9dbbd30e19eb8301bf6a7ece8821c1a082b-0c8cb96-small-slack-auth.webp) *Connect Slack workspace*
![Request to install](/images/kb/a36bd6fd7df81753dc773f9fc8b56ef0cdb8f6566f57a81c5aafbef2373d876e-614cb08-small-request-to-install.webp) *Request to install* 4. 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](/images/kb/4e64844da85c30076e152f4a13bf4ef4637e75f8b1259c131ac8ce84ecb6767b-d16dc24-Slack_Status_Update.webp) *Slack Status Update* ### Webhook Subscriptions A status page administrator can [enable webhook subscriptions](#enable-webhook-subscriptions) so that end users can [receive a webhook](#subscribe-via-webhooks) 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"](/images/kb/24abc3824bd038118e5107cb752aade64b634e5a4c32d337167e76e74ca098d9-b6192ad-small-Select_Webhook.webp) *Select "Webhook"* 5. 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 a notification to this email address if there are issues delivering the webhook. 4. Click **Subscribe Webhook**. > **Source IP Addresses:** Status page webhook notifications are not sent from the IP addresses listed in PagerDuty's [webhook IP documentation](https://developer.pagerduty.com/docs/webhook-ips). That list applies to incident and event webhooks only. The source IP addresses for status page webhook notifications are not published and are subject to change, so we don't recommend relying on IP allowlisting to receive them. If your endpoint is behind a firewall or VPN, authenticate using the token in your webhook URL instead. #### Example Payload ```json JSON { "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: , post_type: , title: , starts_at: , ends_at: , reported_at: , message: , href: , status: , severity: , services: , severity: })>)>, next_update_ms: } ``` ### Unsubscribe from Status Updates - [In the Subscriber Console](#in-the-subscriber-console) - [In a Status Update Email](#in-a-status-update-email) - [Disconnect Slack Connection](#disconnect-slack-connection) - [Unsubscribe a Webhook](#unsubscribe-a-webhook) #### 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](https://slack.com/help/articles/360003125231-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](/images/kb/d96df7af83fdd5a9b20b88e83aaf492f329c45bff448e66ea9eff99290412a4f-fdaace8-small-templates.webp) *Create a status page template* 2. Perform the following:
Field Instruction
Post Type Select the type of post you would like to create a template for: **Incident** or **Maintenance**.
Template Name Enter a **template name**.
Description Enter an _optional_ **template description**.
Incident or Maintenance Status Depending on the post type selected above, you will see either Incident Status or Maintenance Status. Select your post's **status** from the dropdown.
Title Enter an _optional_ **title** for the post.
Message Enter the post **message**.
Impacted Business Services Search 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.
Notifications **Check** this checkbox if you would like status update notifications to be sent to subscribers.
3. 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](/images/kb/14b670204fd857ea6cd3d638f43e5a7d47b936eff8afe37f6f26ff435d677d19-b17be71-small-apply_templates.webp) *New post* ## FAQ **Who will be able to access the status page externally?** Once you [publish](#publish-a-status-update) an External Status Page, any end-user will be able to access it at its public URL. **Can I customize my public URL?** Yes, you can customize the public URL while [creating](#create-an-external-status-page) or [editing](#edit-an-external-status-page) a status page. **What is a subscriber?** 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?** You can customize the layout of your External Status Page during the **Customize** step while [creating](#create-an-external-status-page) or [editing](#edit-an-external-status-page) a status page. **Does the external status page support rich text and hyperlinks?** Yes. The external status page supports rich text and hyperlinks for [incidents](/incident-management/communicate/external-status-page#status-page-incidents), [maintenance posts](/incident-management/communicate/external-status-page#scheduled-maintenance-notices), [templates](/incident-management/communicate/external-status-page#status-page-templates), and [postmortems](/incident-management/communicate/external-status-page#add-a-postmortem-to-a-status-page). To add a hyperlink, right-click on the text and select **Link...** Enter the URL in the modal and click **Save**. ![Adding a link to an external status page](/images/kb/c45245937c16175af582328778de3951c4bf8f83e0e1054626dec72e9eb15ada-dde02c9-link.webp) *Add a link to a status page* **What claim formats does the status page support?** The status page supports CSV and JSON claim formats. For example: - **Single**: e.g., `PPAGE1` or `"PPAGE1"` (with quotes) - **CSV**: e.g., `PPAGE1,PPAGE2` or `"PPAGE1","PPAGE2"` (with quotes) - **JSON Array**: e.g., `["PPAGE1", "PPAGE2"]`