Custom domain
Serve a project's images from a hostname you own. You create DNS records and we issue the certificate.
-
1. Check what you need
A custom domain needs a paid plan. A free trial cannot add one. Each project has one hostname. It has to be a subdomain such as
images.example.com. An apex domain such asexample.comis not supported. -
2. Add the hostname
Open the project in your dashboard. Under Delivery domain, enter the hostname and press Add domain.
-
3. Create the DNS records
The dashboard shows the exact records for your hostname. You create a CNAME that points at
customers.focaltool.com, and the TXT records the dashboard shows, which Cloudflare uses to confirm you own the name.CNAMEimages.example.com CNAME customers.focaltool.comCopy the TXT records from the dashboard. Their names and values are different for every hostname.
If your DNS is also on Cloudflare, set the CNAME to DNS only rather than proxied.
-
4. Wait for validation
Cloudflare usually picks the records up quickly. The dashboard shows the state and has a Check now button to ask again without waiting. DNS changes can take longer to spread.
We issue the certificate and renew it at no charge to you. When your domain is live, the dashboard shows the hostname with a tick and a note that the address with your delivery key still works.
-
5. Change the URLs in your pages
On your own hostname the delivery key is not in the path.
Your domainhttps://images.example.com/unsafe/300x300/products/chair.jpgOn our host the key stays where it is.
Our hosthttps://img.focaltool.com/your-key/unsafe/300x300/products/chair.jpg -
6. Move over when you are ready
Both addresses keep working for as long as the domain is set up, so you can change your pages over a few at a time. If your plan lapses, delivery stops on your domain exactly as it does on our address.
-
If validation does not complete
The dashboard shows what Cloudflare reported. Check each record against the dashboard, then press Check now. If your DNS is on Cloudflare, confirm the CNAME is set to DNS only.
Press Remove to start again with a different hostname.