PLEASE NOTE: In order to improve the security of your platform, as of November 1, 2021, Docebo has discontinued the support of second-level domains.
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
Activate the Custom Domain app as described in the Managing Apps & Features article of the Knowledge Base. The app is listed in the Docebo Additional Features tab.
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).
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 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 are no longer be supported.
We strongly suggest not to use 4th-level domains as you may experience problems with HTTPS certificates.
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. For a third-level custom domain (an example of a third-level custom domain is subdomain.yourcompany.com or www.yourcompany.com), 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.
If a Custom Domain is added without the required SSL certificate, the Superadmins and Power Users of the platform may be unable to impersonate users. This will also negatively affect the ability of Docebo Support to access the platform and provide effective support.
When choosing your email sender address, remember not to reuse your custom or Extended Enterprise domains, as most DNS services do not allow for a CNAME and SPF record to coexist for the same domain. We suggest that you find a similar name. As an example, if you custom domain is learning.mydomain.com, you can configure a sender email address as firstname.lastname@example.org or even use a 4th level domain (e.g. if you custom domain is learning.mydomain.com, use email@example.com as sender email address).