Skip to main content
Blaxel allows you to connect your own domain names to your Blaxel workspace to use when exposing resources. You can also share a verified preview custom domain with another workspace in the same account. The target workspace can use the shared domain for its own previews, while the shared copy stays read-only. When you register a domain, you also enable the use of wildcard subdomains for that domain. For example:
  • If you register mycompany.com, you can use any *.mycompany.com subdomain to create custom URLs.
  • If you register preview.mycompany.com, you can use any *.preview.mycompany.com subdomain to create custom URLs.
  • And so on.
Each domain is uniquely assigned to a region. For example, if preview.mycompany.com is registered in region us-pdx-1, it is not possible to use it in region eu-lon-1 (for example) or any other region. In the Blaxel Console, navigate to Network > Custom Domains in the sidebar and add a new custom domain. Then, you’ll need to configure DNS records with your domain provider. Finally, verify from within Blaxel: after DNS propagation completes, your custom domain will become fully usable. image.webp

Share a custom domain

After you verify a preview custom domain, you can share it with another workspace in the same account.
  • Use a workspace share when one target workspace should get a read-only copy
  • Use an account share when every workspace in the account should be able to use the domain
  • Create previews from the target workspace after the share is in place
Only verified preview custom domains can be shared.
When a target workspace binds a preview to the shared domain, the full host still needs to be unique across the account. If another workspace already uses the same <prefixUrl>.<domain> host, Blaxel returns 409.

Certificate validation methods

Blaxel issues a TLS certificate for each custom domain. The certificate must be validated before the domain becomes usable. Choose the validation method when you create the domain. It cannot be changed afterwards.
  • DNS validation (default): works for every domain type. Blaxel returns a unique validation CNAME record in addition to the routing record. Publish both records with your DNS provider, then click Verify.
  • HTTP validation (private preview): for application domains with exact host names only. Point your domain to Blaxel with the routing record and Blaxel validates the certificate over HTTP, with no validation record to publish. See HTTP validation.

Use a custom domain

Custom domains can currently be used for: Related pages:

Sandbox preview URLs

Create preview URLs and configure fallback routing for custom domains.

HTTP validation

Validate application domain certificates over HTTP without publishing a validation record.

Changelog

Review recent platform updates related to custom domains and previews.
Last modified on October 19, 2026