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.
- Navigate to Status Pages > Create New.
- Set page name, slug, and branding.
- Configure custom domain if needed.
- Set visibility and access controls.
- 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
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
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
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
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
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
| Field | Options | What it does | Recommended |
|---|---|---|---|
| Type | Uptime % / Current status / Response time | What the badge displays. | Uptime % for marketing; Current status for docs. |
| Style | Flat / Plastic / For-the-badge / Social | Visual style — matches shields.io conventions. | Flat for clean modern looks. |
| Window | 24h / 7d / 30d / 90d | Time window for the uptime % calculation. | 30d — the SRE-standard SLA window. |
| Color theme | Auto / Light / Dark | Background color of the badge. | Auto — adapts to the host page. |
Widget options
| Field | Options | What it does | Recommended |
|---|---|---|---|
| Layout | Compact / Full / Sidebar | Vertical/horizontal arrangement. | Compact for headers/footers; Full for dedicated status pages. |
| Theme | Light / Dark / Auto | Match your site's theme. | Auto — follows visitor's system preference. |
| Components shown | All / Pick specific | Which 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.
| Feature | Where in app | Description |
|---|---|---|
| Public status page | Status page editor → Visibility → Public: On | Anyone with the URL can view; SEO-indexable. |
| Uptime badge | Public monitoring → Badges → Uptime | SVG badge for README/docs — auto-updates with current uptime %. |
| Status badge | Public monitoring → Badges → Current status | UP/DEGRADED/DOWN badge for at-a-glance. |
| Widget embed | Public monitoring → Widget | Iframe with live status — drop into your marketing site. |
| Subscriber list | Public monitoring → Subscribers tab | Manage email subscribers — view, export, remove. |
| Custom domain | Status page editor → Custom domain | Branded status.yourcompany.com with automatic TLS. |
| Search-engine indexable | Status page editor → Visibility | Toggle whether search engines can index the public page. |
Next Steps
Continue building your monitoring stack:
