Custom asset domains
Setting up a custom asset domain enables you to serve assets to your visitors using your custom domain instead of the default Kontent.ai asset domain. The links on your webpage will look more trustworthy and have better SEO. Contact us to set up a custom asset domain.
Why use a custom domain?
The asset domain is the domain from which you serve assets such as images, videos, or PDF documents. The main benefits of having a custom domain for your asset links are higher credibility and better SEO:- When visitors open your asset in a new tab and see its URL in full, they'll see that it's associated with your company – unlike when it's served from Kontent.ai's default asset domain. This helps to avoid confusion and makes the links look more trustworthy and official.
- Assets served from your own domain have better search engine optimization because they can be associated with your homepage.
Custom domains and SDKs
Custom asset domains are natively supported when using the Delivery JS SDK. With the JS SDK, you specify theassetsDomain
configuration option and the SDK takes care of the rest.
You can also use your custom domain with other SDKs or without any SDK. In this case, you need to replace the domain in the asset URLs in your app. For example, let’s say you want to use the custom domain assets.customer.com
:
- The Delivery API returns the absolute asset URL in this format:
https://assets-us-01.kc-usercontent.com/ID1/ID2/kontent_ai.png
. - You need to replace the domain part of that URL (that is
assets-us-01.kc-usercontent.com
) to gethttps://assets.customer.com/ID1/ID2/kontent_ai.png
.
Set up a custom asset domain
One custom asset domain is available for every standard subscription. If you need more custom domains, you can purchase them additionally. To set up a custom domain, contact us using the button below so that we can start the activation process.This feature isn’t available for some legacy plan subscriptions. Contact us to find out your options.
1. Choose your domain and select projects
Choose the custom domain you want. We recommend a subdomain of the domain you own. For example, if your domain iscustomer.com
, a valid custom asset domain can be assets.customer.com
or resources.customer.com
.
Select projects for which you want to use the custom domain. You can have multiple projects with one domain or use a separate domain for each project. You can also first test it with one project and have us set up more domains later.