Skip to main content

Status Page Setup

Each status page has its own branding, domain, and display settings. This page covers creating a status page, configuring its appearance, setting a custom domain, and managing page-level settings.

Creating a Status Page

From the Dashboard, click Create Status Page. Provide:

FieldDescription
Page NameThe name displayed at the top of the public page, e.g., "Acme IT Services Status"
SubdomainAuto-generated from the name. Must be unique across all tenants. Lowercase letters, numbers, and hyphens only.

After creation, the page is immediately live at {subdomain}.theonestatus.app.

ℹ️Subdomains cannot be changed after creation. Choose carefully — your clients will bookmark this URL.

Branding

Click the Branding tab on any status page to customize its appearance. Changes are saved and take effect immediately.

Upload a PNG or SVG logo. This appears in the header of the public status page.

Best practices:

  • Use a transparent-background PNG or SVG
  • Recommended size: 200×50px or similar wide-format logo
  • The logo scales to fit the header area

Colors

SettingDescription
Primary ColorHex color code for buttons, links, and accent elements (e.g., #0066CC)
Background ColorPage background color. Defaults to white if not set.

Text

SettingDescription
Header TextShort tagline displayed near the top of the page, e.g., "Service Status for Acme Corp"
Footer TextText at the bottom of the page, e.g., "For support, call 1-800-ACME-IT"

Custom CSS

Advanced users can inject custom CSS to override any visual aspect of the public status page. Enter raw CSS in the Custom CSS field.

⚠️Custom CSS is applied to the public page only. Malformed CSS may break the page layout. Test in a staging page first if making significant changes.

Custom Domain

By default your page is served at {subdomain}.theonestatus.app. You can serve it from your own domain (e.g., status.yourmsp.com) instead.

Setup Steps

  1. Go to the Settings tab of the status page
  2. Under Custom Domain, click Add Custom Domain
  3. Enter the domain you want to use, e.g., status.yourmsp.com
  4. Click Add Domain

The system generates a DNS TXT record for domain ownership verification:

Name:   _statusone-verify.status.yourmsp.com
Value: statusone-verify=abc123xyz...
  1. Add this TXT record to your DNS provider
  2. Return to Settings and click Verify

Once verified, add a CNAME record at your DNS provider pointing your domain to The One Status infrastructure:

status.yourmsp.com  CNAME  {subdomain}.theonestatus.app
  1. SSL is provisioned automatically after DNS propagation (typically 5–30 minutes)
💡If verification fails, wait 15 minutes for DNS to propagate and try again. DNS TTL can delay propagation. Check with dig TXT _statusone-verify.status.yourmsp.com to confirm the record is visible.

Custom Domain Status

The Settings tab shows the current state of your custom domain:

StateMeaning
Pending verificationTXT record added; waiting for DNS propagation
Verified (green)Ownership confirmed; page now served at your domain
SSL: activeHTTPS certificate provisioned

Removing a Custom Domain

In the Settings tab, click Remove next to the custom domain. The page reverts to the default subdomain URL immediately.

Page Settings

On the Settings tab, configure how the public page behaves:

SettingDescriptionDefault
Allow SubscriptionsWhether visitors can subscribe for email/SMS notificationsEnabled
Show Uptime PercentageDisplay 90-day rolling uptime % per componentEnabled
Show Response TimeDisplay response time charts per componentDepends on monitoring config
History DaysHow many days of resolved incidents to show in incident history90
Time ZoneTimezone for displaying dates and times on the public pageUTC
LanguageLanguage for the public page UI (English, Spanish, French, German, Portuguese, Japanese)English

SEO Settings

Control how the status page appears in search results and social previews. Configure in the Branding tab:

SettingDescription
Page TitleBrowser tab title and search result title (defaults to the page name)
DescriptionMeta description for search engines and social link previews

Deleting a Status Page

In the Settings tab, scroll to Danger Zone and click Delete Status Page.

⚠️Deletion is permanent. All components, incidents, subscribers, and history are removed immediately. Subscribers will stop receiving notifications but are not automatically notified of the deletion.