Domain

Every account has a Cademí address. It can also have its own domain, such as courses.yourbrand.com, so students come in under your brand. In Settings → Domain you see the account's addresses, register your own domain and activate the certificate.

The idea in one minute

Three pieces make your own domain work:

• The main address is the address the platform takes the student to.
• The CNAME record is what you create at your DNS provider. It points your domain to Cademí.
• The certificate is the browser padlock (https). Cademí requests the certificate after it checks the CNAME.

The most important rule: your own domain only becomes the main address when its status is Active. Until then, students stay on the Cademí address.

The platform addresses

The Platform addresses section shows the three addresses the platform opens on:

The Cademí addresses always work. Whoever comes in through them is taken to the main address. The main one is the highest priority among those that exist, in this order: Custom Domain (only while it is Active), then Subdomain, then Platform key.

The flow below shows which address is the main one and what happens to whoever comes in through another:

No address stops working: what changes is where the student is taken. A registered domain that has not reached Active yet is not the main one.

Your own domain must be a subdomain, such as courses.yourbrand.com or members.yourbrand.com. A root domain (yourbrand.com) is not accepted. Each domain can be in only one account.

The domain statuses

From registration to Active, the domain goes through these statuses:

Both Processing statuses look the same on screen. In the first, the button is Activate now. In the second, it is Verify certificate. If the certificate comes out ready on activation, the domain goes straight to Active. Redefine Domain goes back to Inactive from any status.

Step by step

Register the domain

1. In the dashboard, open Settings → Domain.
2. In Custom Domain, type the subdomain students will use. For example: courses.yourbrand.com.
3. Click Save now.

The status becomes Processing. The screen shows the Activate now button.

Create the record at your DNS provider

The DNS provider is where your domain was registered or is hosted.

1. Open your DNS provider's panel.
2. Create the record the DNS setup section shows: Type CNAME, name equal to the subdomain (courses) and Points to core.cademi.com.br.
3. To get the target right, use the screen's copy button.
4. Wait for DNS propagation.

Propagation depends on your provider. It can take minutes to hours.

Heads up: this is where most mistakes happen. Marcos uses Cloudflare and creates the CNAME with the orange cloud (proxy) on. The check does not find the CNAME, and the status ends up as Invalid pointing. To avoid this, turn off your provider's proxy or CDN on that record. The check looks for a plain CNAME record pointing to core.cademi.com.br.

Activate the domain

1. Go back to the dashboard and click Activate now.
2. Confirm with Continue.

The platform checks the CNAME and requests the SSL certificate. If the record is right, the message is "CNAME verified! The SSL certificate is being issued and will be activated shortly." The status stays Processing.

Check the certificate

While the certificate is being issued, the screen shows the Verify certificate button.

1. Click Verify certificate.

When the certificate is ready, the status becomes Active and the message is "Domain activated successfully!". If the certificate comes out ready on activation, the status goes straight to Active.

If the check fails

The message says why, and the status shows the diagnosis:

• Invalid: the record was not found. The DNS has not propagated yet, or the record was created under another name.
• Invalid pointing: the record points somewhere else.

Fix it at the provider, wait for propagation and click Activate now again.

What changes with the domain active

• The emails Cademí sends to students use your domain: the access link and the one-click sign-in button.
• Whoever comes in through the Cademí addresses is taken to your domain. Old links keep working.
• The deliveries' Postback URL stays on the Cademí address (Deliveries). Changing or resetting the domain does not affect the sales coming in from the gateways.

Reset

With a domain registered, the Redefine Domain button clears the registration. The status goes back to Inactive. The student area goes back to the Cademí domain, and access through the custom domain stops. You cannot undo this action. To use the domain again, register it once more and repeat the activation.

Good to know

Frequently asked questions