Serve images from custom domains

Image delivery is supported from all customer domains under the same Cloudflare account. To serve images through custom domains, an image URL should be adjusted to the following format:

https://example.com/cdn-cgi/imagedelivery/<ACCOUNT_HASH>/<IMAGE_ID>/<VARIANT_NAME>

Example with a custom domain:

https://example.com/cdn-cgi/imagedelivery/ZWd9g1K7eljCn_KDTu_MWA/083eb7b2-5392-4565-b69e-aff66acddd00/public

In this example, <ACCOUNT_HASH>, <IMAGE_ID> and <VARIANT_NAME> are the same, but the hostname and prefix path is different:

• example.com: Cloudflare proxied domain under the same account as the Cloudflare Images.
• /cdn-cgi/imagedelivery: Path to trigger cdn-cgi image proxy.
• ZWd9g1K7eljCn_KDTu_MWA: The Images account hash. This can be found in the Cloudflare Images Dashboard.
• 083eb7b2-5392-4565-b69e-aff66acddd00: The image ID.
• public: The variant name.

​​ Custom paths

By default, Images are served from the /cdn-cgi/imagedelivery/ path. You can use Transform Rules to rewrite URLs and serve images from custom paths.

To create a rule:

1. Log in to the Cloudflare dashboard and select your account and website.
2. Select Rules > Transform Rules.
3. Select Create rule.
4. Under When incoming requests match…, select Edit expression
5. In the text field, enter (http.request.uri.path matches "^/images/.*$").
6. Under Path, select Rewrite to.
7. Select Dynamic and enter the following in the text field.

regex_replace(
  http.request.uri.path,
  "^/images/",
  "/cdn-cgi/imagedelivery/<ACCOUNT HASH>/"
)

7. Select Deploy when you are done.

​​ Limitations

When using a custom domain, it is not possible to directly set up WAF rules that act on requests hitting the /cdn-cgi/imagedelivery/ path. If you need to set up WAF rules, you can:

• Use a Cloudflare Worker to access your images and a Route using your domain to execute the worker. For an example worker, refer to Serve private images using signed URL tokens.