Skip to Content
🔨 Our docs are still a work-in-progress! Leave feedback here →
DocumentationImage ProxyUsing the Image Proxy

Image Proxy

Enabling the Image Proxy

You can enable the Image Proxy under Site Configuration > Acceleration at the bottom of the page.

How to use it

⚠️

Feature in Beta The Image Proxy is still in beta. We do not recommend enabling this in production yet.

You can automatically modify and optimize images while they are being loaded by your end user. Enabling this allows you to rewrite the URLs you use for images to a new Optimized Image URL, a different subdomain to call in your images from. By using the Optimized Image URL, JPEGs, PNGs, and GIFs loaded in can be compressed and optimized for web automatically. Additionally, by manually changing parts of the URL, you can crop and customize the image.

Manually Changing URLs

You can customize images being loaded in by enabling the Image Proxy and then changing the way that you reference images on your website in your HTML.

If your image tag calls in an image, e.g. mysite.com/images/picture.jpg you can change this to img-cdn.mysite.com/images/picture.jpg. By default, JPEGs and PNGs will be reduced to 80% quality.

OptionAffect
250xResize image to 250px wide
x500Resize image to 500px height
0.20xResize image to 20% of original width
50Crop to 50px square
300x600Crop image to 300px x 600px
50,fitScale to fit 50px square
r90Rotate 90 degrees
fvFlip image vertically
fhFlip image horizontally
pngConvert image to PNG format
q60Reduce image quality to 60% of original

You can also combine options together, e.g. 250,fit,png which would scale to fit a 250px square and convert the image to a PNG format.

To use these settings, you would change the URL you’re using to call the image: img-cdn.mysite.com/250,fit,png/images/picture.jpg

Automatic Optimization

Once you enable the Image Proxy, you can optionally select different file formats that should be optimized automatically. We will rewrite the URL in responses to your site to use the image proxy with a 20% reduction in quality and other optimizations to make the image more web-friendly and fast. There is little to no visual impact on the detail of the images.

Acceleration screen

Last updated on