Incidentsintermediate

Embed the status widget

Add a small live-status indicator to your main website or product, with one of two embeds — a script snippet that adapts to the host page, or an iframe with full color control.

8 min read

Embed the status widget

A small status indicator on your main site means visitors see “all systems operational” or “incident in progress” before they have to click through to the status page. The indicator is a one-line embed and refreshes itself in the background.

Before you start

  • You’ll be pasting a snippet into your own site’s HTML. You need access to that site’s source — or to a CMS that accepts custom HTML embeds.
  • The widget is read-only. It shows current status. With the iframe embed, or the script embed shown in the page, clicking it opens your status page. With the script embed’s floating button, clicking it opens a panel with details and a link to your status page (see step 4).

Steps

1. Open the Embed tab

Go to Settings → Incidents Settings → Embed. You see a configuration panel and a live preview underneath.

2. Pick the embed type

Two options:

  • Script — can be shown in the page (optionally in a container you name with a CSS selector), where it takes the host page’s background, or as a floating button that draws its own card. The most natural-looking embed on a styled site.
  • Iframe — renders the widget inside a sandboxed iframe. You control the color palette; the host page can’t affect it. Use this if you need exact colors or if the host page’s CSS is causing visual issues with the script embed.

3. Pick a theme

For both embed types:

  • Auto — follows the visitor’s system light/dark preference
  • Light — always renders light-on-white
  • Dark — always renders light-on-dark

For the script embed shown in the page, the background comes from the host page, and the theme sets the text, border and icon colors. The floating button draws its own card, and the theme sets its colors too. For the iframe embed, the theme also controls the default palette.

4. (Script only) Choose how it appears

When Script embed is selected, Display appears. The other options below appear when Display is Floating button:

  • Display — In the page, or Floating button
  • Position — Bottom right, or Bottom left
  • Button — Icon and status, Icon only, or Icon and your text
  • Show — Always, or Only during incidents and maintenance
  • Open on a new outage — A switch

Choosing Icon and your text adds a Button text field where you type the label. With In the page, an optional Container field takes a CSS selector for the element that holds the widget. With Open on a new outage on, the panel opens by itself when a new outage starts. It opens once per outage, and a visitor who closes it keeps it closed.

Clicking the floating button opens a panel showing:

  • Your current status
  • The worst open incident, with its latest update
  • Any maintenance window
  • A link to your status page

On phones the panel appears as a bottom sheet.

The live preview shows how your choices look. With Floating button, use its Incident and Maintenance examples to see those states, and switch between Desktop and Phone width to check both layouts.

5. (Iframe only) Customize colors

When iframe + light or iframe + dark is selected, seven color pickers appear. Each controls one part of the widget:

  • Background — The widget’s overall background
  • Border — The widget’s outer border
  • Title — Text color
  • Subtitle — Secondary text
  • Operational — The indicator when all systems are healthy
  • Degraded — The indicator for degraded performance
  • Outage — The indicator for an outage

Each picker shows a hex input and a swatch. Defaults match the theme; change anything and the preview reflects it immediately.

Auto theme can’t be customized (it would need both a light and dark palette), so the color pickers only appear for the explicit theme.

6. Copy the snippet

Two snippets are generated at the bottom of the panel — one for script, one for iframe. The active one is shown based on your Embed type choice. Click Copy next to the snippet.

The script snippet looks like:

<script src="https://your-tenant.atender.dev/api/public/incidents/your-slug/widget.js" data-theme="dark" async></script>

The iframe snippet looks like:

<iframe src="https://your-tenant.atender.dev/incidents/your-slug/embed?theme=dark"
        width="100%" height="72" style="border:0;display:block" title="Status"></iframe>

(URLs use your actual tenant domain and slug. The script snippet may carry additional attributes for the display options you chose, so re-copy it after changing them.)

7. Paste it into your site

Drop the snippet wherever you want the indicator to appear:

  • In a header or footer — small, persistent, always visible.
  • Next to “Need help?” links — gives context if the site itself is degraded.
  • On a /status redirect page — some teams keep a slim landing that contains just the widget and a link to the full page.

For the Floating button display, paste the snippet before the closing body tag on every page instead. The button floats in the corner you chose.

The widget refreshes its data periodically in the background, so it stays accurate without you having to do anything.

Verify it worked

Open the page where you pasted the snippet. The widget should appear, showing your current status — “All Systems Operational” with a green dot, or the most severe active incident’s status.

If you’ve got an active incident, the widget should show the incident’s status and severity. For the iframe embed, or the script embed shown in the page, clicking it opens your public status page. For the script embed’s floating button, clicking it opens the panel, which links to your public status page.

When to use which embed type

  • You want the widget to take on your site’s background — Script
  • You want a floating button or a details panel — Script
  • You need predictable colors regardless of the host page — Iframe
  • Your CMS strips <script> tags — Iframe
  • The widget is rendering with broken styles on the host site — Iframe (sandboxed)
  • Default — you don’t have strong preferences — Script

Troubleshooting

  • Symptom: Widget doesn’t render after pasting. Fix: For script embeds: the script is async, so it can take a moment to appear. Check the browser console for errors. For iframe embeds: confirm the iframe URL loads directly in a new tab.
  • Symptom: Colors look wrong on the iframe embed. Fix: Check that theme is set in the URL. If you customized colors but they’re not appearing, the URL probably doesn’t carry the query params — re-copy from the Embed tab.
  • Symptom: Embed shows “All Systems Operational” but there’s a live incident. Fix: The widget caches briefly. Hard-refresh the host page. If the issue persists, confirm the live incident’s status isn’t already resolved.
  • Symptom: The script widget isn’t visible even though it’s installed. Fix: If Show is set to Only during incidents and maintenance, the widget stays hidden while everything is operational. Switch it to Always to confirm it’s working.

See also

Tags

How To