How to embed our status widget?

The AdminLabs Status Widget is a lightweight, customizable component that allows you to display your service status directly on your website. It provides real-time status updates and automatically refreshes to keep your users informed about your service’s operational state.

Basic implementation

You can fetch your status widget embed code directly from your status page’s tools, from the “Embed code” tab from our dashboard:

1. Click the wrench icon for the status page you wish to embed:

2. Navigate to the “Embed code” tab and follow the instructions there:

Configuration options

The widget supports several configuration options that you can customize:

Basic options

• statusPageId (Required): The ID of your status page
• showDescription (Optional, default: true): Whether to show a short status description under the overall status, like “1 open incident”

Custom translations

You can customize the text displayed in the widget by providing your own translations:

window.adminlabsWidgetSettings = {
    statusPageId: "YOUR_STATUS_PAGE_ID",
    translations: {
        status: {
            loading: "Loading status...",
            ok: "All systems operational",
            warning: "Warnings in some systems",
            error: "Systems not operational",
            notice: "Warnings in some systems",
            maintenance: "Maintenances in some systems",
            last_updated: "Last updated: {time}",
            checking: "Checking status...",
            widget: {
                error: "Service status unavailable",
                error_description: "Last check failed"
            }
        },
        description: {
            openIncidents: {
                singular: "{count} open incident",
                plural: "{count} open incidents"
            }
        }
    }
};

Status types

The widget supports the following status types, each with its own color scheme:

• ok: All systems operational
• warning: Warnings in some systems
• error: Systems not operational
• notice: Warnings in some systems
• maintenance: Maintenance in progress
• loading: Initial loading state

Troubleshooting

If the widget doesn’t appear:

1. Verify that the statusPageId is correct
2. Check the browser console for any error messages
3. Ensure the widget container element exists in the DOM
4. Verify that the script is loading correctly
5. You can add debug: true to the settings to get a debug output of the widget initialization process