Embedding a Full Status Page

Last updated: 2026-04-16

If you want to show your full hosted status page inside your own product, admin panel, help center, or customer portal, you can now embed a chrome-free version directly in an <iframe>.

This is different from the Live Widget and Embeddable Status Banner: instead of rendering a compact hosted widget, this mode shows the full public status page layout without the outer navbar and footer.

How It Works

Add ?embed=1 to your public status page URL.

Example:

https://your-slug.statuspage.me?embed=1

In embed mode:

• The public status page keeps its normal content and live status data
• The outer navbar and footer are removed
• The selected Page Theme still applies
• Your existing branding and Custom CSS still apply
• Links from the embedded page open in a new tab so the iframe stays embedded cleanly

Where to Set It Up

1. Go to Status Pages in your dashboard
2. Open the status page you want to embed
3. Go to Settings > Visual > Advanced
4. Find Embed in your website
5. Copy the generated URL ending with ?embed=1

You can also choose a Page Theme in the same area before embedding.

For the full settings layout, see Status Page Settings Guide.

Basic iframe Example

<iframe
  src="https://your-slug.statuspage.me?embed=1"
  title="System status"
  width="100%"
  height="900"
  style="border:0;"
  loading="lazy"></iframe>

Replace the URL with your own public status page URL or custom domain.

Allowed Frame Origins

By default, leaving Allowed frame origins empty allows any website origin to embed the page when ?embed=1 is used.

If you want to restrict embedding to specific websites, enter a space-separated list of origins in Allowed frame origins.

Example:

https://www.example.com https://app.example.com

Use full origins only:

• Include https://
• Do not include paths
• Separate multiple origins with spaces

When configured, embed mode uses these origins to build the page’s frame-ancestors policy.

Page Themes in Embedded Mode

The embedded page uses the same Page Theme as the normal public page.

Available presets:

• Default
• Minimal Edge
• High Contrast
• Soft Cloud
• Terminal

These presets control layout density, typography, tick-bar styling, card radius, and overall visual tone. They do not replace your accent color or custom CSS.

For a broader branding overview, see Branding Your Status Page.

When to Use Full-Page Embedding

Use iframe embedding when you want the whole hosted status page experience inside another surface, for example:

• Customer portals
• Internal admin dashboards
• Help centers
• Product settings areas
• Hosted documentation sites

If you only need a compact status summary, a lighter embed is usually a better fit:

• Use Embeddable Status Banner for a slim in-app notice
• Use Live Widget for a compact script-based widget
• Use Embed Status API if you want to render your own UI

Troubleshooting

The page does not load inside my iframe

• Confirm you are using the ?embed=1 URL
• If you configured Allowed frame origins, make sure the embedding site matches one of them exactly
• Check your browser console for iframe or Content Security Policy errors

The navbar or footer still appears

Make sure the iframe URL ends with ?embed=1. Without that query parameter, the page renders in normal full-page mode.

The page style is not what I expected

• Check the selected Page Theme in Status Pages > Settings > Visual > Advanced
• Review any Custom CSS you have applied to the status page
• If you changed branding recently, refresh the embedded page after cache expiry

What’s Next?

• Review status page settings
• Customize your branding and Page Theme
• Use the Live Widget for a lighter embed
• Use the Embeddable Status Banner for a slim hosted notice
• Build custom embeds with the Embed Status API