> ## Documentation Index
> Fetch the complete documentation index at: https://docs.spacemedia.uk/llms.txt
> Use this file to discover all available pages before exploring further.

# Set up custom domains for your portal

> Configure a branded subdomain or custom domain for your SpaceMedia organization portal, check DNS status, and verify domain resolution.

# Domains

Each organization can use a branded subdomain and, when configured, a custom domain.

## Domain fields

| Field                  | Meaning                                                                        |
| ---------------------- | ------------------------------------------------------------------------------ |
| `tenant_subdomain`     | Organization subdomain identifier.                                             |
| `tenant_base_domain`   | Base domain used to build the organization subdomain URL.                      |
| `subdomain_url`        | Computed URL for the branded subdomain.                                        |
| `tenant_domain`        | Optional custom domain owned by the organization.                              |
| `domain_update_status` | Current backend status for a requested custom domain update.                   |
| `domain_dns_status`    | DNS status payload showing whether the domain resolves to the expected target. |

## DNS expectation

A custom domain should point to the SpaceMedia enterprise host supplied by the dashboard. The dashboard performs DNS checks and reports the current status; it does not require API clients to pass cross-organization domain selectors.

## Production checklist

* Confirm the domain owner controls DNS.
* Add the CNAME record requested in the dashboard.
* Wait for propagation before using the custom domain in customer-facing launch material.
* Keep the branded subdomain active as the fallback access path.