Skip to main content

Getting Started with The One Status

This guide walks you through creating your first status page, adding components, and publishing it so clients can see live service health.

Accessing The One Status

  1. Log in to The One Stack at your Hub URL
  2. Click the waffle menu (grid icon) in the Hub Bar
  3. Select Status from the product list
  4. You land on the Dashboard showing all your status pages
ℹ️The One Status requires the Status entitlement on your organization. Contact support if Status does not appear in the product menu.

Initial Setup Checklist

  1. Create a status page — Give it a name and subdomain
  2. Add components — Model each service or system your clients rely on
  3. Configure branding — Logo, colors, and custom domain (optional)
  4. Enable subscriptions — Allow clients to subscribe for notifications
  5. Share the URL — Link clients to yourpage.theonestatus.app

Key Concepts

TermDefinition
Status pageA public-facing page that shows the health of your services. Each page has a unique subdomain and can be branded independently.
ComponentA service or system shown on the status page — e.g., "Help Desk", "Client Portal", "Phone System". Each component has an independent status.
Component groupA named section that organizes related components — e.g., grouping all "Network Services" together.
IncidentA declared service disruption. Incidents have a title, severity, affected components, and a timeline of status updates.
Maintenance windowA scheduled period of planned downtime or degraded performance with advance notice sent to subscribers.
SubscriberA client who has opted in to receive email or SMS notifications when something changes on your status page.
PostmortemA post-incident report published to the public status page explaining what happened, the root cause, and corrective actions.

Step 1: Create Your First Status Page

  1. From the Dashboard, click Create Status Page
  2. In the dialog:
    • Enter a Page Name — e.g., "Acme IT Services"
    • The Subdomain auto-fills from the name — e.g., acme-it-services (editable; lowercase letters, numbers, and hyphens only)
  3. Click Create
  4. You are taken directly to the status page management view

Your page is now live at yoursubdomain.theonestatus.app. It starts empty — no components yet.

💡Use a subdomain your client will recognize. If you manage multiple clients, consider one page per client: acme.theonestatus.app, contoso.theonestatus.app.

Step 2: Add Components

Components are the individual services shown on the public page.

  1. Click the Components tab
  2. Click Add Component
  3. Fill in:
    • Name — e.g., "Help Desk"
    • Description (optional) — brief note for clients, e.g., "Ticket submission and technician communication"
    • Status — start with "Operational"
  4. Click Save

Repeat for each service you want to track. Common examples for MSPs:

  • Help Desk
  • Remote Support
  • Client Portal
  • Phone System
  • Email Services
  • VPN / Remote Access
  • Backup Services
💡You can group related components together. See Component Management for component groups.

Step 3: Configure Branding

Give the page your MSP's identity:

  1. Click the Branding tab
  2. Upload a Logo (displayed at the top of the public page)
  3. Set a Primary Color (hex value — matches your brand color)
  4. Optionally set Background Color, Header Text, and Footer Text
  5. Click Save Branding

The public page updates immediately.

Step 4: Enable Subscriptions

To let clients subscribe for notifications:

  1. Click the Settings tab
  2. Ensure Allow Subscriptions is enabled
  3. Optionally configure:
    • Show Uptime Percentage — display 90-day uptime % per component
    • History Days — how many days of incident history to show (default: 90)
    • Time Zone — display times in this zone on the public page
  4. Save changes

Step 5: Share the URL

Your status page is now live and ready to share. From the Dashboard, each page card shows the public URL (yoursubdomain.theonestatus.app). Click the external link icon to open it in a new tab and confirm it looks correct before sharing with clients.

💡Add the URL to your client onboarding documents, your website footer, and your email signatures so clients know where to check service health before submitting a ticket.

What's Next