General Settings and Domains
Update organization details, timezone, contact email, and branded access domains.
Use Settings > General to control the basic organization record and the domains learners use to reach the site. This page is for admins who manage organization settings and domain setup.
Before you begin
You need:
- Access to Admin Dashboard > Settings > General.
- Permission to change organization settings.
- For custom domains, access to your DNS provider.
- A domain or subdomain you are allowed to use, such as
learn.example.com.
Changing the organization name or timezone can affect what admins and learners see across the product. Changing domains can affect sign-in links, bookmarks, and any links you have already shared.
Review the page
What is on this page
The General Settings page has two main areas:
- General Settings: Organization Name, Description, Contact Email, and Timezone.
- Domain Management: Custom domains and Built LMS subdomains, including verification and SSL status.
Update organization details
- Open Admin Dashboard > Settings > General.
- In Organization Name, enter the name learners and admins should see.
- In Description, add a short internal description of the organization.
- In Contact Email, enter the address learners or system emails should use when they need an organization contact.
- In Timezone, select the organization's default timezone.
- Select Save General Settings.
After saving, the page shows Settings Saved. If the organization record cannot load, the page shows a load error above the form. Refresh first; if the message remains, sign out and sign back in so your organization context can be reloaded.
Manage domains
Choose a domain type
Domain Management supports two domain types:
| Domain type | Example | Use it when |
|---|---|---|
| Custom Domain | learn.yourcompany.com | You want learners to use a domain you control. You must configure DNS and verify ownership. |
| Subdomain | yourorg.builtlms.com | You want a Built LMS-hosted subdomain. Subdomains are automatically verified and include SSL. |
Custom domains require more setup, but they are usually the right choice for a public learner portal because the address belongs to your organization.
Add a Built LMS subdomain
- Open Admin Dashboard > Settings > General.
- In Domain Management, select Add Domain.
- Choose Subdomain.
- Enter a subdomain that ends in
.builtlms.com, such asyourorg.builtlms.com. - Select Add Domain.
Subdomains are automatically verified. The domain list refreshes after the
domain is added. If the subdomain does not end in .builtlms.com, the form
shows Subdomains must end with .builtlms.com.
Add a custom domain
- Open Admin Dashboard > Settings > General.
- In Domain Management, select Add Domain.
- Choose Custom Domain.
- Enter the full domain, such as
learn.yourcompany.com. - Select Add Domain.
The domain is added with a verification status. For a custom domain, the next step is DNS verification.
The custom domain field expects a valid domain name. Use the full hostname you
want learners to visit. Do not enter a URL with https://, a path, or a trailing
slash.
Verify a custom domain
After adding a custom domain, open its card in Domain Management. Pending custom domains show setup instructions and a Verify Domain button.
The setup flow can show one of these steps:
| Step | What it means | What to do |
|---|---|---|
| Ownership verification | Built LMS needs proof that you control the domain. | Add the TXT or CNAME verification record shown on the domain card to your DNS provider. |
| DNS configuration | Ownership is verified, but traffic still needs to route correctly. | Add the required A or CNAME record shown on the domain card. |
| SSL provisioning | DNS is correct and SSL certificate setup is in progress. | Wait for the certificate to finish provisioning. |
| Complete | Verification and SSL are complete. | Test the domain in a browser. |
When the verify dialog appears, it reminds you to configure the DNS record before verifying. The fallback verification record is:
| Type | Name | Value |
|---|---|---|
| CNAME | Your custom domain | cname.vercel-dns.com |
DNS changes can take up to 48 hours to propagate worldwide. Many providers update faster, but wait before retrying if you recently changed records.
Read domain statuses
Each domain card shows Verification and SSL Certificate.
Verification statuses:
| Status | Meaning |
|---|---|
| pending | Built LMS has not confirmed the domain yet. Add the DNS records and select Verify Domain. |
| verified | Domain ownership and routing have been confirmed. |
| failed | Verification failed. Check DNS records, wait for propagation, then select Retry Verification. |
SSL statuses:
| Status | Meaning |
|---|---|
| pending | SSL certificate setup has not completed yet. |
| issued | A certificate exists and is activating. |
| active | HTTPS is ready for the domain. |
| expired | The certificate is no longer valid. Contact support before sending learners to this domain. |
Remove a domain
- Open Admin Dashboard > Settings > General.
- In Domain Management, find the domain.
- Select Remove.
- Confirm the delete dialog.
Removing a domain deletes its configuration from the organization. Do this only after you have moved learner links and sign-in links to another working domain.
Verify and support general settings
Verify success
A working domain setup has these signs:
- The domain appears in Domain Management.
- Verification is
verified. - SSL Certificate is
active. - The domain opens over HTTPS.
- Learners can sign in from the domain you intend to use.
Troubleshooting
Refresh the page. If the error stays, sign out and sign back in. Domain Management needs an organization ID before it can list or add domains.
Check that you entered only the domain, such as learn.example.com. Do not
include https://, a path, query string, or trailing slash.
Confirm the DNS record type, name, and value match the records shown in the domain card. DNS providers format record names differently; some expect only the subdomain label, while others expect the full hostname.
If verification is complete but SSL is still pending or issued, wait for certificate provisioning to finish. Do not announce the domain to learners until HTTPS works.