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

# Set up sending domains

> Add custom tracking and sending domains to your project, verify their DNS records, and brand link-wrapping and email under your own domains.

Custom domains move tracking and sending off Spotzee's shared domains and onto your own. Tracking domains brand the URLs in your emails and push notifications. Sending domains brand the From address. Both improve deliverability and reduce the risk of being lumped in with someone else's reputation.

> [!NOTE]
>
> Domain configuration lives under **Settings** → **Domains** and requires the project `admin` role. You'll need DNS access to the parent domain to add the records Spotzee asks for.

## Two kinds of domain

Spotzee distinguishes two domain types. The DNS setup differs.

| Type | What it does | Records you'll add |
| - | - | - |
| **Tracking** | Hosts the wrapped links Spotzee inserts into emails and push notifications, so click-throughs go through your domain | One `CNAME` record |
| **Sending** | The domain your email From address lives on | DNS records supplied by the configured sending service |

You can run both on the same parent domain or split them. Common patterns:

* `go.example.com` (tracking) plus `mail.example.com` (sending).
* `t.example.com` (tracking) plus `example.com` (sending, root domain).
* One agency-style sub-domain per project for white-label work.

## Add a tracking domain

**1. Open Settings → Domains**

Inside the project, open **Settings** and pick the **Domains** tab.

**2. Add a tracking domain**

Choose **Add domain**, enter the hostname you want to use (for example, `go.example.com`), and pick **Tracking** as the type. Save.

**3. Add the CNAME at your DNS provider**

Spotzee shows the **CNAME value** for the domain. Add a `CNAME` record at your DNS provider where:

* **Name**: the subdomain you chose (`go`).
* **Type**: `CNAME`.
* **Target**: the value Spotzee displayed.
* **TTL**: 300 or your provider's default.

**4. Verify**

Back in Spotzee, choose **Verify** on the domain. Spotzee checks the CNAME and provisions the SSL certificate. The status moves from **Pending** to **Verified** once both the DNS record and SSL are ready. SSL provisioning can take a few minutes.

**5. Enable the domain**

Once verified, enable the domain. Spotzee starts using it for new sends immediately. Existing wrapped links keep working through the previous tracking domain until they expire.

## Add a sending domain

Sending domains must already exist in the connected sending service. In **Settings** → **Domains**, choose **Add domain**, enter the hostname, and select **Sending**. Spotzee checks that the service knows the domain, then adds it and shows the DNS records returned by that service. If the service does not recognise the domain, the add request fails. Add the displayed records at your DNS provider and review them in the domain's **DNS records** view.

Sending domains enter Spotzee as **Verified** after the service lookup. Their DNS records and status differ from the tracking-domain SSL flow.

## Verification statuses

Each domain carries an overall status and an SSL status (tracking domains only).

| Status | Meaning |
| - | - |
| **Pending** | DNS not yet detected, or detected but SSL still provisioning. |
| **Verified** | DNS records match what Spotzee expects, and SSL is active for tracking domains. |
| **Error** | One or more DNS records failed verification. The status reason explains which. |
| **Inactive** | Domain disabled by an admin. Disabled domains aren't used for new sends. |

Tracking-domain verification can be repeated after DNS or SSL changes.

## Bulk import for many domains

Agencies and white-label operators can use bulk CSV import to add many domains at once.

**1. Download the CSV template**

In **Settings** → **Domains**, the bulk import action gives you a CSV template with the columns Spotzee expects.

**2. Fill the CSV**

Add one tracking-domain hostname per row under the `Domain` column. This CSV flow does not import sending domains.

**3. Upload**

Upload the CSV. Spotzee provisions tracking domains and reports successful, failed, and skipped rows. Failed rows include reasons so you can fix and retry them.

**4. Verify in batch**

Use the bulk **Verify all** action once your DNS is in place. Spotzee checks eligible domains and reports their outcomes.

## Disable or remove a domain

Disabling a domain stops new sends from using it but preserves the configuration so you can re-enable later. Removing a domain deletes the configuration. Once removed, links wrapped through that domain stop resolving and any email sent from it will be rejected by recipient mail servers.

Disable rather than remove unless you're sure no historical campaigns will send again, and any tracking links wrapped through the domain have already expired or moved to a replacement.

## Next steps

> [card] [Set up email delivery](https://spotzee.com/docs/guides/configure-email-delivery.md)
>
> Connect SMTP, SendGrid, Mailgun, or Amazon SES.

> [card] [Set up a project](https://spotzee.com/docs/guides/setup-project.md)
>
> Toggle email and push link wrapping on or off.

> [card] [Provider catalogue](https://spotzee.com/docs/guides/providers.md)
>
> See which providers handle each channel type.

> [card] [Build templates](https://spotzee.com/docs/guides/templates.md)
>
> Use the new sending domain in your email From address.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.