PLEASE NOTE: In order to improve the security of your platform, as of November 1, 2021, Docebo will discontinue supporting second-level domains. If you have configured your custom domain as a pure second-level domain (i.e. mydomain.com), please update it to a third-level domain (i.e. www.mydomain.com or subdomain.mydomain.com) as described in this article, before November 1, 2021, in order to comply with the new standard. Check out the Product Updates page for more details.
With Docebo’s Custom Domain app, you can set a custom domain name for your platform. This feature is available in the Docebo Advanced Plan, for Enterprise customers, and within Docebo trials. This article outlines how to activate and configure the Custom Domain app in your platform.
Use Case Scenarios
A useful scenario for the Custom Domain app is when, at your company, you as a platform Superadmin would like to redirect your users to a different URL than the docebosaas.com URL that was provided with the contract. Updating the docebosaas.com URL to a known company URL will make it easier for the learners to remember and navigate the platform’s URL.
First, make sure that the custom domain that you would like to change the platform URL to is purchased and owned by your company. Additionally, your company will need to purchase an SSL certificate to ensure that the site is secure when the redirect is in place. Lastly, your company will need to update your domain name system (DNS) settings once the custom domain is added to the platform along with the SSL certificate. Once the custom domain is created and selected in the platform, the SSL certificate is successfully uploaded, and the DNS settings are updated, the redirect will be in place. With the custom domain enabled, the user can simply go to the site via the custom domain, for example at https://learn.mycompanyname.com, to access the platform as opposed to the docebosaas.com URL.
What is a Domain?
A domain name is a unique branded name that identifies a website. Learners can use this domain to access your learning platform. Your domain must be registered with a domain registrar.
How do I register a Domain?
In order to replace your standard Docebo domain with a custom domain, you first need to register a domain with a domain registrar if you have not already done so. There are many options available to you when it comes to domain registrations. When you register a domain, your contact details are connected to it. The Internet Corporation for Assigned Names and Numbers (ICANN) oversees the domain name system (DNS) and gives registrars the ability to register a domain to a single individual or corporation. Please note that Docebo does not provide domain registration or DNS services and cannot provide support for a domain registered with a third party.
Activating the Custom Domain App in Docebo
To activate the Custom domain app in your Docebo platform, log in to your platform as the Superadmin and press the gear icon in the top right corner of the page to access the Admin Menu. At the top of the menu, select the Add New Apps button.
On the Apps and Features page, select the Additional Features tab from the tab menu on the left. Then, find the Custom Domain application in the app list and press the Try It For Free button in the app’s row. If you are exploring Docebo’s features with a trial platform, you will see information related to the validity of the application’s activation. Now, review the information in the pop-up box, and press Try It For Free to confirm the activation. Once you have activated the app, you can begin to configure it.
Configuring the Custom Domain App
Once the Custom Domain app is activated, your platform is accessible at your custom domain once the app is properly configured and your DNS record is updated according to the DNS record configuration requirements outlined in the section below. The order in which you complete these does not matter.
To configure the app in your platform, access the Admin Menu, then press the Add New Apps button. Find the Custom Domain app in the My Apps tab, then click the Setup wheel. In the Domain Name text box, type in your domain name.
Enter your domain name with the prefix www in the Domain Name text box (example: www.yourcompany.com and not yourcompany.com). If you would like to use a second level domain (example: yourcompany.com) you must prefix it with "www". This will facilitate the updating of SSL certificates for HTTPS use in case you decide to activate them.
Once you are satisfied, press Save Changes. Otherwise, press Cancel to return to the Apps and Features page.
On the next page, confirm that your custom domain name is correct by flagging the Confirm checkbox, and press Continue to submit your domain name and return to the Settings page. If your custom domain name is incorrect, press Back to make corrections before re-submitting the information.
Please Note: Any domain name containing the extension "docebo", "dcbstatic.com", or capital letters will not be accepted.
Once your domain name is accepted, on the Settings page you will see both a confirmation message and message warning that you are not able to update your domain name for a few minutes. Additionally, you'll see the custom domain DNS record configuration requirements provided for your information. For second-level domains, you will need to add an A record in your DNS system using the IP address provided. You will also need to add a CNAME record to your DNS entries for docebosaas.com and your custom domain. For third-level domains, you will require only a CNAME entry to redirect your custom domain name to yourbusinessname.docebosaas.com. If your domain’s DNS record is updated according to the below DNS record configuration requirements, your platform will be accessible at your custom domain.
Please note that after November 1st, 2021 second-level domains will no longer be supported. It is strongly recommended to use only third-level domains (such as www.yourbusinessname.com or learningsystem.yourdomainname.com).
DNS Record Configuration Requirements
Your platform is accessible at your custom domain once your domain’s DNS record is updated according to these DNS record configuration requirements and the Custom Domain application is configured. The order in which you complete these steps does not matter.
Typically DNS servers are provided by your domain registrar, your hosting provider or they are self-hosted on your corporate network. If you are unsure how to edit DNS records you may need to contact your provider for further assistance. The following data will need to be provided:
- For a Second Level Custom Domain. An example of a third-level custom domain is yourcompany.com. Starting on November 1, 2021, Docebo will discontinue supporting second-level domains.
- For a Third Level Custom Domain. An example of a third-level custom domain is subdomain.yourcompany.com or www.yourcompany.com. Here, you will only need to provide a CNAME record, redirecting your third-level domain to yourcompany.docebosaas.com.
To secure communications with your custom domain, it's recommended HTTPS on your custom domain with Docebo's HTTPS app.