Built LMS Help Center
Settings

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

  1. Open Admin Dashboard > Settings > General.
  2. In Organization Name, enter the name learners and admins should see.
  3. In Description, add a short internal description of the organization.
  4. In Contact Email, enter the address learners or system emails should use when they need an organization contact.
  5. In Timezone, select the organization's default timezone.
  6. 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 typeExampleUse it when
Custom Domainlearn.yourcompany.comYou want learners to use a domain you control. You must configure DNS and verify ownership.
Subdomainyourorg.builtlms.comYou 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

  1. Open Admin Dashboard > Settings > General.
  2. In Domain Management, select Add Domain.
  3. Choose Subdomain.
  4. Enter a subdomain that ends in .builtlms.com, such as yourorg.builtlms.com.
  5. 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

  1. Open Admin Dashboard > Settings > General.
  2. In Domain Management, select Add Domain.
  3. Choose Custom Domain.
  4. Enter the full domain, such as learn.yourcompany.com.
  5. 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:

StepWhat it meansWhat to do
Ownership verificationBuilt 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 configurationOwnership is verified, but traffic still needs to route correctly.Add the required A or CNAME record shown on the domain card.
SSL provisioningDNS is correct and SSL certificate setup is in progress.Wait for the certificate to finish provisioning.
CompleteVerification 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:

TypeNameValue
CNAMEYour custom domaincname.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:

StatusMeaning
pendingBuilt LMS has not confirmed the domain yet. Add the DNS records and select Verify Domain.
verifiedDomain ownership and routing have been confirmed.
failedVerification failed. Check DNS records, wait for propagation, then select Retry Verification.

SSL statuses:

StatusMeaning
pendingSSL certificate setup has not completed yet.
issuedA certificate exists and is activating.
activeHTTPS is ready for the domain.
expiredThe certificate is no longer valid. Contact support before sending learners to this domain.

Remove a domain

  1. Open Admin Dashboard > Settings > General.
  2. In Domain Management, find the domain.
  3. Select Remove.
  4. 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

On this page