DISCLAIMER: In order to improve the security of your platform, starting on November 1, 2021, Docebo will dismiss the support for 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 by 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. The DNS settings can be configured for third-level custom domains only. 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 custom domain site to access the platform as opposed to the docebosaas.com URL.
What is a Custom Domain?
A custom domain name is a unique branded name that identifies a website. Learners can use this domain to access your learning platform. Your custom domain must be registered with a domain registrar.
How do I register a Custom Domain?
In order to replace your standard Docebo domain with a custom domain, you first need to register a custom 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 is not an expert on custom domains and cannot provide support for your custom domain.
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 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 your 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 textbox, type in your domain name.
Enter your domain name with the prefix www in the Domain Name textbox (example: www.yourcompany.com and not yourcompany.com). This will subsequently facilitate the updating of HTTPS certificates in case you decide to activate them.
Then, 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 a confirmation message and another 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 below for your review. 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.
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.
If you aren’t a technology expert, you may need to provide the following data to your Internet Service Provider:
- For a Second Level Custom Domain. An example of a second-level custom domain is yourcompany.com. Starting on November 1, 2021, Docebo will dismiss the support for 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 confirm the CNAME, as yourcompany.docebosaas.com.
To secure communications with your custom domain, it's recommended HTTPS on your custom domain with Docebo's HTTPS app.