AppStatus Documentation Hub for Production Operations

Docs > Operations > Public Monitoring

Public Monitoring - AppStatus Docs

Overview

This guide introduces AppStatus Public and covers:

  • Create branded public status pages for your services
  • Generate embeddable uptime badges and widgets
  • Configure subscriber notifications for status updates
  • Customize branding and design for public pages
  • Control what monitoring data is shared publicly
  • Password-protected private status pages

What are AppStatus Public?

Public monitoring features allow you to share service health and uptime data with external stakeholders through branded status pages, embeddable widgets, and uptime badges. Keep your customers informed about service availability and incident status with transparent communication.

Configure which monitors to display publicly, customize the branding and design, and set up subscriber notifications so stakeholders receive updates when incidents occur. Use password protection for private status pages that require authentication.

Key capabilities:

  • Branded public status pages with custom domains
  • Embeddable uptime badges for your website
  • Status widgets for dashboards and documentation
  • Email subscriber notifications for updates
  • Password-protected private status pages
  • Customizable branding and design
  • Incident history and maintenance windows
  • Multi-language support

Service Workflows

Each workflow maps to real AppStatus features and API endpoints used in the main app.

Status Page Setup

Create and configure public status pages for your services.

  1. Navigate to Status Pages > Create New.
  2. Set page name, slug, and branding.
  3. Configure custom domain if needed.
  4. Set visibility and access controls.
  5. Publish the status page.

Troubleshooting

Status page not updating

Verify monitors are mapped to the status page. Check if the status page is active and public. Review the update interval and refresh settings.

Custom domain not working

Ensure DNS is configured correctly. Verify SSL certificate is valid. Check the custom domain is properly set in status page settings.

Badge showing incorrect status

Verify the monitor ID in the badge URL is correct. Check if the monitor is active and reporting data. Review the badge style parameters.

Subscribers not receiving notifications

Verify email addresses are valid. Check notification settings are enabled. Review email delivery logs for bounce or spam issues.

Operational Guidance

  • Keep public status pages updated during incidents.
  • Use clear and consistent status messaging.
  • Test public pages before sharing with customers.
  • Review and update public monitoring regularly.

Step-by-Step Setup

Public monitoring is everything customers can see without logging in: your branded status page, embeddable uptime badges and widgets, and email subscriptions for incident updates. This section is about making the work you already did (monitors, status page, incidents) visible and shareable outside your workspace.

Before you start

  • A status page already created (see the Status Pages guide)
  • Monitors mapped to public components on that page
  1. 1

    Make the status page public

    Open your status page editor and switch Visibility → Public to On. Save. The page becomes reachable at https://<slug>.appstatus.io and search engines can index it.

    WhereStatus pages → your page → Visibility → Public: On → Save
  2. 2

    Open the Public monitoring tab

    Each status page has a Public monitoring tab in its detail page. This is where you find badges, widget embed codes and the subscriber list.

    WhereStatus page detail → Public monitoring tab
  3. 3

    Generate an uptime badge

    Pick a monitor from the dropdown and choose a badge style. AppStatus generates a permanent SVG URL that always reflects the monitor's current uptime — drop it into your GitHub README, your docs, or a marketing page. The badge updates automatically as state changes.

    WherePublic monitoring → Badges → Select monitor + style → Copy
  4. 4

    Embed the live status widget

    The widget is an iframe you can paste into your website footer, hero, or pricing page. Visitors see live status without leaving your site. The widget inherits your status page branding.

    WherePublic monitoring → Widget → Copy embed code
  5. 5

    Promote the subscribe button on the public page

    The Subscribe button on your public status page lets customers receive incident notifications by email. Manage subscribers (export, remove) from the Subscribers tab inside Public monitoring.

    WherePublic monitoring → Subscribers tab

Configuration Options

Every option you can set, what each choice means, and what to pick. Use this as a reference while you fill in the form.

Badge options

FieldOptionsWhat it doesRecommended
TypeUptime % / Current status / Response timeWhat the badge displays.Uptime % for marketing; Current status for docs.
StyleFlat / Plastic / For-the-badge / SocialVisual style — matches shields.io conventions.Flat for clean modern looks.
Window24h / 7d / 30d / 90dTime window for the uptime % calculation.30d — the SRE-standard SLA window.
Color themeAuto / Light / DarkBackground color of the badge.Auto — adapts to the host page.

Widget options

FieldOptionsWhat it doesRecommended
LayoutCompact / Full / SidebarVertical/horizontal arrangement.Compact for headers/footers; Full for dedicated status pages.
ThemeLight / Dark / AutoMatch your site's theme.Auto — follows visitor's system preference.
Components shownAll / Pick specificWhich status page components appear in the widget.Pick only your customer-critical components.

Feature Reference

Every feature, where to find it in the app, and what it does. Use this when you know what you want to do but not where it lives.

FeatureWhere in appDescription
Public status pageStatus page editor → Visibility → Public: OnAnyone with the URL can view; SEO-indexable.
Uptime badgePublic monitoring → Badges → UptimeSVG badge for README/docs — auto-updates with current uptime %.
Status badgePublic monitoring → Badges → Current statusUP/DEGRADED/DOWN badge for at-a-glance.
Widget embedPublic monitoring → WidgetIframe with live status — drop into your marketing site.
Subscriber listPublic monitoring → Subscribers tabManage email subscribers — view, export, remove.
Custom domainStatus page editor → Custom domainBranded status.yourcompany.com with automatic TLS.
Search-engine indexableStatus page editor → VisibilityToggle whether search engines can index the public page.

Next Steps

Continue building your monitoring stack: