Skip to main content

​
Overview

Every App gets a default URL at {slug}.mxp.co. You can also serve it on your own subdomain — for example, search.yourcompany.com — by adding a custom domain and creating a DNS CNAME record.

​
Add a custom domain

1

Open the Domains panel

In the App details page, click the Domains tab.
2

Enter your subdomain

Type the subdomain you want to use (e.g. search.yourcompany.com) and click Add Domain.
3

Create a CNAME record

In your DNS provider, add a CNAME record pointing your subdomain to your app’s Cloudflare Pages hostname:
{slug}.pages.dev
TypeNameValue
CNAMEsearch.yourcompany.com.pages.dev
4

Wait for verification

Mixpeek polls for DNS propagation and automatically provisions a TLS certificate via Cloudflare. Domain status changes to active once the certificate is issued (usually within a few minutes).

​
Domain statuses

StatusMeaning
pendingDNS record not yet detected
verifyingRecord found, issuing TLS certificate
activeDomain is live and serving HTTPS
failedVerification failed — check your CNAME value

​
Via API

from mixpeek import Mixpeek

client = Mixpeek(api_key="your-api-key", namespace_id="ns_...")

domain = client.apps.domains.add(
    app_id="app_...",
    domain="search.yourcompany.com",
)
print(domain.status)  # "pending"

​
Notes

  • Only subdomain CNAMEs are supported (not apex/root domains).
  • Each domain can be attached to one App at a time.
  • Removing a domain does not affect the App’s default {slug}.mxp.co URL.