Custom Domains

By default, Middleware hosts your status page at a subdomain like yourcompany.mwstatus.com. With a custom domain, you can serve the same page from your own URL — for example, status.yourcompany.com — so it matches your brand and existing DNS.

Custom domains require an active paid billing plan.

How custom domains work#

Middleware uses Cloudflare for SaaS to provision SSL and route traffic from your custom domain to your status page. When both a hosted slug and a custom domain are configured, the custom domain always takes priority as the serving domain.

Set up a custom domain#

1 Open status page settings#

Go to Synthetics → Status Page, open your page, and select the Settings tab.

2 Enter your domain#

In the Custom domain name field, enter the full domain you want to use (e.g. status.yourcompany.com). Click Check to validate availability and register the domain with Cloudflare.

If your billing plan is not active, the custom domain field is disabled. Upgrade from Settings → Billing to enable this feature.

3 Create a CNAME record#

After validation, Middleware displays the CNAME target your DNS record must point to. The target follows this pattern:

1{your-account-uid}.mwstatus.com

For example, if your account UID is abc123, create a CNAME record:

Type	Name	Value
CNAME	`status` (or your subdomain)	`abc123.mwstatus.com`

The CNAME must point to your account's Middleware-hosted domain — not to a subdomain derived from your own domain name.

Add this record in your DNS provider (Cloudflare, Route 53, etc.) and wait for propagation. DNS changes can take up to 48 hours, though most providers propagate within minutes.

4 Publish#

Click Publish on the Settings tab to save your configuration. Once DNS propagates and Cloudflare confirms the hostname, your status page is accessible at your custom domain.

A badge labeled Custom domain appears in the tab bar showing your serving domain. Click it to open the live page.

Hosted slug vs custom domain#

Option	URL example	Requirements
Hosted slug	`yourcompany.mwstatus.com`	Available on all plans; slug validated at publish time
Custom domain	`status.yourcompany.com`	Active paid billing; CNAME DNS record required

You can configure both simultaneously. Visitors who go to the hosted slug are redirected to the custom domain when it is active.

Hosted slug rules#

When using a Middleware-hosted subdomain:

Use only letters, numbers, and hyphens
Do not include dots or spaces
Account aliases, app names, user aliases, and predefined names are not accepted
Slug availability is checked when you publish

Troubleshooting#

Custom domain field is disabled

Upgrade to a paid plan from Settings → Billing.

Domain validation fails

Verify the domain is not already in use by another status page
Ensure you entered the full domain without https:// or trailing slashes
For hosted slugs, check that the slug does not conflict with reserved names

Page not loading on custom domain

Confirm the CNAME record points to {account-uid}.mwstatus.com, not to your own domain
Wait for DNS propagation (use dig or your DNS provider's lookup tool to verify)
Click Check again in Settings to refresh Cloudflare hostname status

SSL certificate issues

Middleware provisions SSL automatically through Cloudflare. If you see certificate errors, ensure the CNAME is correct and allow time for Cloudflare to issue the certificate (typically a few minutes after DNS propagates).

Next steps#

Getting Started — full setup walkthrough
Status Badges — embed code uses your serving domain automatically

Need assistance or want to learn more about Middleware? Contact our support team at [email protected] or join our Slack channel.