Custom Branding & Domain
CloudFiles allows you to completely white-label the document viewer with your company logo and custom domain. In this article, we talk about accessing the settings page, updating brand logo and website and finally setting up CNAME mapping so that we can enable custom domain on your account.
In order to white-label your CloudFiles Document Viewer, you first need to purchase Enterprise license. You can refer to the article to check Purchasing and assigning licenses
In order to set your custom branding & domain, you need to be logged in with your admin account. You can access the CloudFiles Admin dashboard by simply clicking on the gear icon on top right. This is detailed in the steps and the GIF below -
- Click the gear icon ⚙️ on the top right of the navbar.
- Click on the Accounts button in the left sidebar
Once you are in your account page, you can easily set your logo, favicon & website using the steps below -
- Click the edit icon on top to open Account Details Editor
- Upload your logo by clicking on the Upload button on top
- Add your website & account name
- Your favicon will be automatically pulled from our website
Once you have followed these steps, your CloudFiles previews & links should start showing your favicon & logo. Even your old links would update. The customization steps are shown in the GIF below -
For example, if your logo is "iDEMO" and your domain is "idemo.com," so, once you've completed the steps, they will appear as follows:
In order to add your custom domain, you first need to map CloudFiles with your DNS provider. This process is called CNAME mapping and is usually handled by IT teams in large organizations. Although the steps may change based on the DNS provider, here are the main steps to be followed. If you are not the IT admin, it is best to get them involved so they can easily understand and implement these
- Open the DNS settings
- Create a new record with type CNAME
- For that record, host = the subdomain name you want. This can be anything that you like, for example - docs, files etc.
- For value, add cname.cloudfiles.io
- For TTL select 5 minutes. Your new sub-domain will become accessible after this much time.
Once the CNAME Mapping is done, you can add the custom domain through the setting provided in the Branding section. Follow the steps below in order to do the same.
- Click on the Configure button to initiate the process, this will result in prompting a input to add your custom domain, click Continue once you have added the domain. Refer to the image given below for further explanation.
- Once you have clicked "Continue", the system will attempt to configure your domain. If the domain is successfully configured you will see "Active" state. You may get "Missing Configuration" state otherwise, as shown in the image below.
After the CNAME mapping is completed on our side, your links will update. Your old links will continue to work but won't redirect to the new links. CloudFiles keeps the link slug same but replaces the prefix. E.g. https://cloudfiles/slug will become https://docs.yourdomain.come/slug
