Skip to content
Focal

Custom domain

Serve a project's images from a hostname you own. You create DNS records and we issue the certificate.

  1. 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 as example.com is not supported.

  2. 2. Add the hostname

    Open the project in your dashboard. Under Delivery domain, enter the hostname and press Add domain.

  3. 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.

    CNAME
    images.example.com  CNAME  customers.focaltool.com

    Copy 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. 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. 5. Change the URLs in your pages

    On your own hostname the delivery key is not in the path.

    Your domain
    https://images.example.com/unsafe/300x300/products/chair.jpg

    On our host the key stays where it is.

    Our host
    https://img.focaltool.com/your-key/unsafe/300x300/products/chair.jpg
  6. 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.

  7. 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.