Installing the Sorry™ Script

The Sorry™ Script lets you display real-time status badges on any website with just a few lines of code.

Important: In all examples below, replace status.yourdomain.com with your actual status page domain (e.g., status.acme.com ).

Add the Script (One-time setup)

Place this single line in the <head> section of your site (or just before the closing </body> tag):

<script
   src="https://status.yourdomain.com/script.js"
   defer
   async>
</script>

Display the main Status Badge

Add this tag anywhere in the where you want the overall status badge to appear:

<img 
  src="https://status.yourdomain.com/badge.svg" 
  width="24" 
  height="24" 
  alt="Current system status" 
  loading="lazy"
/>

Display a Component-Specific Badge

To show the status of a specific status page within a Collection, use its URL slug:

<img 
  src="https://status.yourdomain.com/services/{service-slug}/badge.svg" 
  width="30" 
  height="30" 
  alt="{Service Name} status" 
  loading="lazy"
/>

Tip: The slug is the lowercase, hyphenated part after/services/ in the component page URL.

Customise Polling Interval (optional)

By default, badges refresh every 5 seconds. Change the frequency by adding data-polling-interval (value in milliseconds) to the script tag:

<script 
  src="https://status.yourdomain.com/script.js" 
  data-polling-interval="60000"
  defer 
  async>
</script>

Common values:

10000 → every 10 seconds
30000 → every 30 seconds (default)
60000 → every 60 seconds

Private Status Pages

Status badges are not supported on private pages at this time — the badge will show a 404 error.

Workarounds:

Create a separate public status page for customer-facing badges, or
Use the Status API to build your own custom badge (see API documentation).

Troubleshooting

Badge not appearing/updating? Open browser dev tools → Console and check for errors (especially CORS or mixed-content warnings).
White/blank badge? Double-check that you replaced status.yourdomain.com correctly and that the script loaded successfully.

That’s all you need! Your status badge will now stay in sync automatically.