Status Page Widget

What is a Status Widget?

A status page widget is a small, embeddable component that displays your website's operational status in real-time. Instead of visitors wondering if your service is down, they can immediately see the current status, uptime percentage, and when the last incident occurred.

MerySpeak's widget requires just a single line of code to embed and automatically updates every 60 seconds. It works on any website and comes in both light and dark themes to match your site's design.

The widget displays:

• Current Status: Green "Operational" or Red "Down" indicator
• Uptime Percentage: Your site's availability over recent periods
• Last Incident: When the most recent downtime occurred

Key Features

How to Embed the Widget

Adding the status widget to your website takes just three steps:

1. Get Your Widget Code

   Log into your MerySpeak dashboard, select a website, and click "Get Embed Code" to copy the widget snippet.

2. Add to Your HTML

   Paste the script tag into your website's HTML, typically in the footer or status page section.

3. Customize (Optional)

   Change the data-theme attribute to "dark" for dark mode, or keep "light" for the default appearance.

Embed Code Example

<script src="https://meryspeak.com/static/js/embed.js"
        data-website-id="YOUR_WEBSITE_ID"
        data-theme="light"></script>

Replace YOUR_WEBSITE_ID with your actual website ID from the dashboard. The widget will render automatically where you place the script tag.

Widget Themes

The widget comes in two themes to match your website design:

Use Cases

Why Display Public Status?

Many companies hesitate to show uptime data publicly, but transparency provides significant benefits:

• Builds trust: Customers appreciate honesty about service reliability
• Reduces support load: Users can self-serve status checks instead of contacting support
• Demonstrates confidence: Showing uptime implies you're confident in your infrastructure
• Differentiates from competitors: Many competitors hide their downtime - transparency stands out
• Manages expectations: During incidents, users know you're aware and working on it
• Improves accountability: Public metrics encourage teams to maintain high standards

Widget API

The widget fetches data from our public API endpoint. If you want to build a custom status display, you can access the same data directly:

Endpoint

GET /api/widget/{website_id}

Response

{
  "success": true,
  "data": {
    "status": "up",
    "uptime_24h": 100.0,
    "uptime_7d": 99.95,
    "uptime_30d": 99.87,
    "last_checked": "2025-01-15T10:30:00Z",
    "last_incident": "2025-01-10T08:15:00Z"
  }
}

CORS is enabled for this endpoint, allowing you to fetch data from any domain.