Domains
By default Marketix hosts your short links on its own application domain. You can add your own custom domains per project so that links use your own branding (for example go.example.com/slug).
The domains list
Section titled “The domains list”Open Domains from the sidebar. The table shows every domain added to the project:
| Column | Description |
|---|---|
| Domain | The domain name |
| Root redirect | Where bare-domain visitors are sent (if configured) |
| 404 redirect | Where visitors with an unknown slug are sent (if configured) |
| Status | Three status pills: DNS, Reachable, SSL |
| Actions | Check now, Edit, Delete |
The last checked timestamp appears next to the status pills.
Adding a custom domain
Section titled “Adding a custom domain”Click Add domain. The DNS information box at the top of the form shows the record you must create before the domain can pass verification:
CNAME →
{app-domain}
Create a CNAME record in your DNS provider pointing your custom domain to the Marketix application domain shown in that box. After DNS propagates, Marketix automatically provisions an SSL certificate — this can take a few minutes.
Form fields
Section titled “Form fields”| Field | Required | Description |
|---|---|---|
| Domain name | Yes | The custom domain, e.g. links.example.com |
| Root redirect | No | Where to send visitors who access the bare domain with no slug |
| 404 redirect | No | Where to send visitors when a slug is not found |
Submit the form to save the domain. The domain is created with all status checks in Pending state (no check has run yet).
Domain status checks
Section titled “Domain status checks”Marketix checks three things when you verify a domain:
| Check | What it tests |
|---|---|
| DNS | Whether the domain resolves to the correct IP addresses |
| Reachable | Whether an HTTP request through the domain reaches the Marketix app |
| SSL | Whether a valid SSL certificate is installed |
The reachability check works by fetching /.well-known/marketix through your custom domain. Marketix serves a small JSON response at that path; if it arrives, the domain is confirmed to route through the application correctly.
Status pill states
Section titled “Status pill states”Each of the three checks shows one of three states:
- Green (✓) — check passed.
- Red (✗) — check failed.
- Gray (–) — check has not run yet (pending).
The overall domain health is:
- Healthy — all three checks pass.
- Error — at least one check failed.
- Pending — checks have not run yet.
When a check fails, the edit page shows an error detail below the corresponding pill (for example, SSL error message or reachability error message). The resolved IP addresses are displayed when DNS is healthy.
Running a status check
Section titled “Running a status check”You can trigger a check at any time. On the domains list, click the Check button in the actions column for the domain. On the edit page, click Check now in the status box. The check runs synchronously and the page reloads with updated results.
Editing a domain
Section titled “Editing a domain”Click Edit in the domains list or click the domain name. The edit form shows the same fields as the create form. You can also see and run a status check from this page, and an activity history is displayed listing all changes to the domain’s name and redirect settings.
Deleting a domain
Section titled “Deleting a domain”Click Delete in the domains list. The domain is removed from the project. Any short links that were assigned to this domain will no longer resolve.
Using a custom domain when creating links
Section titled “Using a custom domain when creating links”Once a domain is added (it does not need to be fully verified to be selectable), it appears in the Domain dropdown when you create or edit a short link. Select it to assign the link to that domain. See Links for the full link creation workflow.