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 .

Accessing the accounts settings page 

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 -

1. Go to https://app.cloudfiles.io and sign-in with your registered admin email
2. Click the gear icon ⚙️ on the top right of the navbar.
3. Click on the Accounts button in the left sidebar

Adding logo, favicon & website 

Once you are in your account page, you can easily set your logo, favicon & website using the steps below -

1. Click the edit icon on top to open Account Details Editor
2. Upload your logo by clicking on the Upload button on top
3. Add your website & account name
4. 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 -

CNAME Mapping for custom domain 

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

1. Go to your DNS provider where yourdomain.com DNS is purchased from.
2. Open the DNS settings
3. Create a new record with type CNAME
4. For that record, host = the subdomain name you want. This can be anything that you like, for example - docs, files etc.
5. For value, add cname.cloudfiles.io
6. For TTL select 5 minutes. Your new sub-domain will become accessible after this much time.

Once the CNAME Mapping is done, send us an email on support@cloudfiles.io with the URL that you'd like to use. For example - https://docs.yourdomain.com. We will complete the settings on our side after which white-labelling will be enabled on your account.

How does custom domain affect current links?

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://cloudfil.es/slug will become https://docs.yourdomain.come/slug