If you are switching from a legacy HTTP custom domain, please ensure that you first switch the custom domain off and enable a custom Litmos URL (ex: yourcompany.litmos.com) prior to following these steps. Failure to do so will require Support to reset your domain and may result in some downtime. Please contact firstname.lastname@example.org for any questions you may have or if you would like assistance completing the switch.
Custom domains can be setup for a Litmos account. Once a custom domain has been setup for your Litmos account, the Litmos domain (."litmos.com") will be masked by your custom domain (i.e. "yourcompany.com").
Custom domains need to be configured by an Account Owner with access to the Account --> Features tab. This is where the Account Owner will find the "Custom Domain with SSL" feature.
Important Note: This is a premium feature that must be enabled on your Litmos account before an Account Owner can access the custom domain configuration and complete the custom domain setup. Please contact your Litmos Account Manager to learn more about how to purchase this feature.
Once the feature has been enabled on your account, clicking into the Custom Domain feature will route the Account Owner to the custom domain setup:
Please follow the steps as listed in Litmos to register your custom domain with your hosting provider, and return to Litmos to complete the custom domain SSL validation:
"Custom domains allow you to customize your website URL (i.e. www.mylitmos.com). An SSL certificate will be generated for this domain once the custom domain is setup in Litmos. Please follow the steps below to complete the setup:
Step 1: Register a domain with a Domain Name Registrar (such as Namecheap, Bluehost, HostGator, Hostinger, Google Domains, GoDaddy, etc.). This usually costs somewhere between US $5-$40 per year.
Step 2: Follow the registrar's instructions to create a CNAME for your domain that points to customer.litmos.com (for clients using the Australian Litmos site, please use customer.litmos.com.au, and for clients using the EU Litmos site, please use customer.litmoseu.com).
Step 3: Enter the domain into the text field and click "Add". This step is to ensure that the domain is available on Litmos.
Step 4: If the domain is available, click on "Generate SSL" to generate an SSL certificate for the domain you have chosen. Please note that it can take several minutes for the certificate to be issued. The certificate issuance status can transition from "Initializing" to "Pending Validation" to "Pending Issuance" to "Pending Deployment" as it goes through the SSL validation phase, before it is finally "Active".
Step 5: Check back on the the certificate status. Once the domain shows as "Active", proceed to click enable. Now your Litmos custom domain can be used.
When a domain is available to use in Litmos, it will say "available for use in Litmos":
After Litmos verifies that the custom domain is available to register and use, proceed to click "Generate SSL" if that is the domain your organization desires. If this is not the domain your organization wants to register, select "change" and enter a new domain. Litmos may limit the number of times you "change" your domain, so proceed to validate and "change" domains with care.
Once you've chosen to validate a custom domain, the domain name will be pending SSL certificate validation. This can take several minutes or longer, so please be sure to check back on the status of the SSL certification. Once the SSL certification has been validated, your custom domain will be available for use.