Setting up the Atlassian Statuspage integration for Guide

What's my plan?

Suite

Growth, Professional, Enterprise, or Enterprise Plus

Support with

Guide, any plan

The Atlassian Statuspage integration for Guide allows customers to see status page incidents on your help center pages. This keeps customers informed of any service incidents or degradation, reducing the need for them to raise support requests. The status widget appears in the help center only when there's an impact to service.

You must be an admin to set up and configure the Atlassian Statuspage widget for Guide and you must have a public page for Atlassian Statuspage. You set up the widget by adding a JavaScript snippet that runs a script to display status page incidents in your help center.

This article contains the following topics:

• Uploading the script as a help center theme asset
• Adding the code snippet to the header template
• Deleting the Atlassian Statuspage widget

Related articles:

• Installing and using the Atlassian Statuspage integration for Support

Uploading the script as a help center theme asset

The first part of setting up the status page integration is uploading the JavaScript file as a help center theme asset.

To upload the JavaScript file to your theme assets

1. Download the statuspage-widget.js file.
2. In Knowledge admin, click Customize design () in the sidebar.
3. On the theme you want to edit, click Customize to open it, then click Edit code.
   
   
   
4. In the assets directory, click Add asset.
   
   
   
5. Select the the statuspage-widget.js file on your computer, and click Open.
   
   
   

Adding the code snippet to the header template

To complete setting up the integration, a script is added in the header template to display status page incidents in your help center.

To add the code snippet to the header template

1. In Knowledge admin, click Customize design () in the sidebar.
2. On the theme you want to edit, click Customize to open it, then click Edit code.
3. In your theme code configuration page under the templates directory, click the header.hbs template file.

   The file content is displayed.

   
   
   
4. In the header.hbs file, paste the following snippet after the <header/> tags:

   <script type="text/javascript" id="statuspage-widget" statuspage="https://YOUR_STATUSPAGE_URL" src="{{asset 'statuspage-widget.js'}}"></script>

   
   
   
5. Replace YOUR_STATUS_PAGE_URL with your public Atlassian Statuspage URL. You can also use the Zendesk test status page URL https://test1282.statuspage.io/ if you need to test and verify your installation.
6. Click Publish. The status page is displayed in your help center.
   Note: If the public Atlassian Statuspage URL is incorrect, or if an invalid JSON is returned, the widget will not appear in your help center. If Atlassian Statuspage is not fully operational, the widget is not displayed.

Deleting the Atlassian Statuspage widget

To delete the integration, delete the statuspage-widget.js theme asset and the snippet you added in the header template of your help center theme.