> For the complete documentation index, see [llms.txt](https://academy.synap.ac/doc/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://academy.synap.ac/doc/integrations/custom-domain-cname.md).

# Custom Domain (CNAME)

Set up a custom subdomain for your Synap portal using CNAME records.

By default, Synap hosts your portal at a synap.ac address, for example `yourportal.synap.ac`. You can move your portal to a subdomain of a domain you own, for example `learn.yourdomain.com` or `exams.yourdomain.co.uk`.

{% hint style="success" %}
Custom subdomains are available on Pro, Business, and Enterprise plans.
{% endhint %}

You can use a custom subdomain on a domain you own. For example, `learning.springfieldelementary.io`.

### Before you begin

1. **Choose your subdomain.** This is the first part of the address and can be anything you like, such as `learn`, `exams` or `training`.
2. **Confirm you own the main domain.** This is the second part of the address, usually your website’s domain, such as `yourdomain.com`. The subdomain you choose must not already be used by another website.
3. **Send your full chosen address to your Synap contact,** for example `learn.yourdomain.com`.

We’ll then send you two sets of CNAME records, one at a time.

We recommend setting up a custom email sender on the same domain as your new subdomain. For example, if your portal is at `learn.yourdomain.com`, emails would come from an address such as `noreply@yourdomain.com`. Email providers increasingly check that emails come from the same domain as the website they relate to. Once your portal moves to your own domain, emails from our default address (`no-reply@synap.ac`) no longer match, which can make them more likely to land in spam. Sending from your own domain keeps everything consistent and helps your portal’s emails reach your users’ inboxes. If you’d like to set this up, let us know the address you’d like to use, and we’ll send you the extra DNS records needed to authorise Synap to send on your behalf.

{% content-ref url="/pages/fYmOeIsT5Nb2C1crSDcu" %}
[Custom Email Sender](https://academy.synap.ac/doc/integrations/custom-email-sender.md)
{% endcontent-ref %}

{% hint style="info" %}
Setting up, validating and moving over to a custom domain can take a few working days, we'd recommend getting both the custom domain and email sender set up well before any key launch or assessment dates.&#x20;
{% endhint %}

### **Step 1: Add the validation records (set 1)**

The first set of records proves to us that you own your domain.

Add the records we send you to your domain’s DNS settings. The record name is usually your subdomain, such as `learn`. Most DNS providers add your main domain automatically, but some need the full hostname, such as `learn.yourdomain.com`. If you need help, check your DNS provider’s guide, for example [GoDaddy](https://www.godaddy.com/en-uk/help/add-a-cname-record-19236) or [123 Reg](https://www.123-reg.co.uk/support/domains/how-do-i-set-up-a-cname-record-on-my-domain-name/).

Let us know once you’ve added them. DNS changes can take up to 48 hours to propagate, and we’ll check the records before moving on to Step 2. You can check them yourself with [DNS Checker](https://dnschecker.org/#CNAME/).

### Step 2: Add the redirection records (set 2)

Once we’ve confirmed the first set, we’ll send the second and final set of records. These point your new subdomain to the server we’ve set up for your portal.

Add them the same way as in Step 1, then let us know:

1. That the records have been added
2. When you’d like your new domain to go live

### 3. Go live

Once the final records are in place, we’ll switch your portal over to your new domain on your chosen date. Please note:

* You and your users will log in at your new address from that point on.
* Saved passwords won’t carry over, because browsers save passwords per domain. Users may need to re-enter or reset their password on the new address.
* Your previous synap.ac address will still work, but all links, buttons and emails from the portal will point to your new domain.


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation by asking a question.

Perform an HTTP GET request on the following URL with the `ask` and `goal` query parameters:

```
GET https://academy.synap.ac/doc/integrations/custom-domain-cname.md?ask=<question>&goal=<user_goal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is what the user is ultimately trying to achieve, the reason they need the answer. Sharing it helps GitBook give you a better, more relevant answer. A goal is most helpful when it describes the outcome the user wants rather than restating the question. For example, with `ask=how do I create an API token`, a goal like `automate deployments from our CI pipeline` lets GitBook tailor the answer to that use case.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
