Status Pages

Status pages provide a public view of your service health, keeping users informed during outages and building trust through transparency. PixoMonitor status pages are fully customizable and can be hosted on your own domain.

Overview

Your status page displays:

  • Overall system status — Aggregate health across all components
  • Component status — Individual service health (API, Website, Database, etc.)
  • Active incidents — Ongoing issues and updates
  • Recent incidents — Past 30 days of incident history
  • Uptime charts — Visual uptime history for each component

Creating Components

Components organize your monitors into logical groups on your status page. For example, you might have components for "API", "Website", "Database", and "CDN".

Add a Component

1

Navigate to components

Go to Status PageComponents.

2

Create a new component

Click Add Component and enter:

  • Name — Display name (e.g., "API")
  • Description — Optional description
  • Position — Display order on the status page
3

Assign monitors

Edit your monitors and set the Component field to assign them to the component.

Component Groups

For complex systems, organize components into groups:

  1. Create a Component Group (e.g., "Core Infrastructure")
  2. Assign components to the group
  3. Groups appear as collapsible sections on the status page

Only monitors assigned to components appear on the public status page. Use this to hide internal monitors from public view.


Status Page Settings

Customize the appearance and behavior of your status page.

Basic Settings

SettingDescription
TitleStatus page title (e.g., "Acme Status")
Homepage URLLink to your main website
Logo URLCustom logo image URL

Display Options

OptionDescriptionDefault
Show Bar ChartsDisplay uptime history barsOn
Show Uptime PercentageShow uptime % for each componentOn
Show Overall PercentageShow aggregate uptimeOn
Show Outage DetailsShow error messages publiclyOn
Show Monitor URLDisplay monitored URLsOff
Enable Details PageLink to detailed monitor viewsOn
Hide Paused MonitorsExclude paused monitorsOff
Show Footer BrandingShow "Powered by PixoMonitor"On

Layout Options

OptionValuesDescription
Layout DensityWide / CompactAmount of whitespace
Layout AlignmentLeft / CenterContent alignment

Theme Options

OptionValuesDescription
ThemeLight / Dark / AutoColor scheme
Accent ColorAny hex colorBrand accent color

Custom Domains

PixoMonitor's default hosted status surface is available at https://pixomonitor.com/status. Paid plans can associate an account-specific status page with a verified custom domain such as status.yourcompany.com.

Prerequisites

  1. Access to your DNS settings
  2. A subdomain such as status.yourcompany.com
  3. A paid PixoMonitor plan with custom-domain access

Setup

1

Add the CNAME record

In your DNS provider, create a CNAME record for the subdomain and point it to pixomonitor.com.

TypeName (Host)Value (Target)
CNAMEstatuspixomonitor.com
2

Wait for DNS propagation

Wait until a public DNS lookup for your complete hostname returns the CNAME. DNS propagation time depends on your provider and the record's TTL.

3

Verify in PixoMonitor

Go to Status PageSettingsCustom Domain, enter the complete hostname without https://, and choose Verify Domain. PixoMonitor verifies that the CNAME resolves to pixomonitor.com and records the hostname for your account.

4

Test the public hostname

Open https://status.yourcompany.com and confirm that it serves your status page. DNS verification records the account association; if HTTPS or routing does not become available, contact PixoMonitor support with the verified hostname.

Troubleshooting

  • CNAME record not found — Wait for propagation and confirm that you created a CNAME, not an A record.
  • CNAME points elsewhere — Update the target to pixomonitor.com. If Cloudflare proxying hides the CNAME during verification, temporarily use DNS-only mode.
  • Domain already in use — Remove it from the other PixoMonitor account or use another subdomain.
  • Verified but not loading — Confirm public DNS first, then contact support; DNS verification alone does not diagnose edge routing or TLS.

Removing a Custom Domain

Go to Status PageSettingsCustom Domain, choose Remove Custom Domain, and remove the CNAME from your DNS provider if it is no longer needed.

Password Protection

Restrict access to your status page with a password. This is useful for internal status pages that shouldn't be public.

Enable Password Protection

1

Go to settings

Navigate to Status PageSettings.

2

Enable protection

Toggle on Password Protected.

3

Set a password

Enter a password that viewers will need to access the page.

4

Save

Click Save. Visitors will now see a password prompt.

Password protection is basic shared-secret access. Do not use a status page to publish confidential system details or credentials.


Announcements

Post announcements on your status page to communicate scheduled maintenance, feature updates, or other news that doesn't require a full incident.

Create an Announcement

1

Navigate to announcements

Go to Status PageAnnouncements.

2

Create announcement

Click New Announcement and fill in:

  • Title — Headline for the announcement
  • Content — Full message content
  • Type — Info, Warning, Critical, or Maintenance
  • Schedule — Optional start and end dates
3

Publish

Set status to Active to display on the status page.

Announcement Types

TypeUse CaseDisplay Style
InfoGeneral updates, new featuresBlue banner
WarningPotential issues, degraded serviceYellow banner
CriticalUrgent announcementsRed banner
MaintenanceScheduled maintenance noticesGray banner

Scheduled Announcements

Set Start At and End At times to automatically show and hide announcements. Perfect for maintenance window notices.


Custom CSS

Advanced users can inject custom CSS to fully customize the status page appearance.

Add Custom CSS

Go to Status PageSettings and add CSS in the Custom CSS field:

/* Example: Custom font */
body {
  font-family: 'Inter', sans-serif;
}
 
/* Example: Custom colors */
.status-operational {
  color: #22c55e;
}

Custom CSS is applied to the public status page in the browser. Enter only CSS you trust and test the public page after saving changes.


Subscriber Notifications

Visitors can submit an email address and verify ownership through a confirmation link. Verified subscribers receive email for incident creation, later incident updates, and resolution.

Subscriber emails follow the incident lifecycle. Announcements are displayed on the status page but are not subscriber-email events.


Status Page Widgets

Embed status information on your own website with widgets.

Badge Widget

Display a simple status badge:

<iframe 
  src="https://pixomonitor.com/api/status/widget?mode=badge" 
  width="200" 
  height="40" 
  frameborder="0"
></iframe>

Full Widget

Display a mini status page:

<iframe 
  src="https://pixomonitor.com/api/status/widget?mode=full" 
  width="400" 
  height="300" 
  frameborder="0"
></iframe>

Widget Options

ParameterValuesDescription
modebadge / fullWidget size
themelight / darkColor theme

Access embed codes from Status PageSettingsWidget Embed Code for ready-to-use snippets.


SEO Settings

Control how search engines index your status page.

Robots Meta Tag

OptionDescription
IndexAllow search engines to index the page
NoIndexTell search engines not to index

Google Analytics

Add your Google Analytics ID to track status page visitors:

  1. Go to Status PageSettings
  2. Enter your Google Analytics ID (e.g., G-XXXXXXXXXX)
  3. Save changes

Public vs. Private Data

The public page is designed for service-health information:

Shown publicly:

  • Monitor and component names
  • Component and monitor health
  • Response times and uptime percentages
  • Incident history and published post-mortems
  • Error messages when outage details are enabled
  • Monitor URLs when Show Monitor URL is enabled

Not part of the public response:

  • Alert-channel credentials or API secrets
  • Monitor configuration fields
  • Escalation-policy configuration

Keep Show Monitor URL disabled for targets you do not want to disclose, and review the public page after changing display settings.


Best Practices

  1. Use descriptive names — Component names should be meaningful to users
  2. Group logically — Organize components by service area
  3. Brand your page — Add your logo and use custom domains
  4. Enable subscriptions — Let users opt-in to notifications
  5. Post updates — Use incidents to communicate during outages
  6. Hide internal monitors — Don't assign internal services to components
  7. Test the public view — Regularly check what users see