---
title: Set Up a Custom Domain
description: Connect and verify a custom domain for your Edvello academy and learn which links use your org URL.
---

Every organization gets a default site at `https://<siteName>.edvello.com`. You can connect your own domain (for example `https://learn.yourcompany.com`) so students see your brand in the browser bar and in links.

## How Edvello picks a base URL

When Edvello builds a link for your organization, it resolves the host in this order:

1. **Verified custom domain** → `https://<your-domain>`
2. **Self-hosted override** (`DASHBOARD_ORIGIN` env var, if set)
3. **Development** → `http://localhost:5173`
4. **Academy URL** → `https://<siteName>.edvello.com`
5. **Fallback** → `https://app.edvello.com`

Most customer-facing course links use your org context and stop at step 1 or 4. The `app.edvello.com` fallback applies when no academy URL is available.

## Set up your domain

### 1. Open domain settings

From the admin dashboard, go to **Settings → Domains**, then click **Edit domain**.

### 2. Enter your domain

Add the hostname you want (for example `learn.yourcompany.com`). Follow the DNS instructions Edvello shows to verify ownership.

### 3. Wait for verification

Verification can take time while DNS propagates. The domain must show as verified before links use it.

### 4. Test on the live site

Open your custom domain in a browser. Sign in, open a course landing page, and confirm URLs stay on your domain.

:::warning[Verification required]
An unverified custom domain is not used for generated links. Until verification succeeds, Edvello keeps using `<siteName>.edvello.com`.
:::

## Which links use your org URL

| Link type                                | Uses org domain when verified?                 |
| ---------------------------------------- | ---------------------------------------------- |
| Course enrollment (`/course/.../enroll`) | Yes                                            |
| Course invite emails from **People**     | Yes                                            |
| Org site landing page and course catalog | Yes                                            |
| Organization team invite (some flows)    | May still use platform URL until fully aligned |

Course invites are documented in [Invite Students](/manage-students/invite-students). Those links should point at your academy, not `app.edvello.com`, when your domain is verified.

## Email sender address

Invite and notification emails may still send from the Edvello platform mail address. Your **organization name** appears in the message body; the sender inbox is not fully white-labeled today.

## Student login and redirects

Students should sign in on your academy so sessions and redirects stay on your academy URL. If login sends users to `app.edvello.com` unexpectedly, check that the custom domain is verified and that you are sharing academy links (not the generic app URL).

## Related guides

- [Customize Your Organization](/organization-and-team/customize-organization) — org profile and default subdomain
- [Customize Your Academy Landing Page](/publish-and-brand/org-landing-page) — public homepage on your domain
- [Invite Students](/manage-students/invite-students) — enrollment links on your academy
- [How Course Enrollment Works](/manage-students/course-enrollment) — enrollment paths and org signup
- [Organization](/reference/organization) — org settings overview