Coming from Thumbor

Moving from Thumbor

Thumbor is a server you run; this edge is one you do not. Its /unsafe/ URLs can be served as they are, so moving is a hostname change.

What is different

Thumbor fetches each image through a loader, usually HTTP or a file store, and writes the operations into the path, such as /unsafe/fit-in/300x200/filters:quality(80)/photo.jpg. This edge does the same work as a service: it fetches from an HTTPS origin you set, and takes the same instructions as query parameters. With URL compatibility on, it reads your Thumbor paths as they are.

Moving, step by step

  1. Make sure the images your loader reads are at an HTTPS origin, and create an account with that origin.
  2. Turn on URL compatibility for Thumbor on the console's Limits tab, or for one hostname on the Domains tab.
  3. Point your Thumbor hostname at your delivery hostname with a CNAME, or replace it in your templates. /unsafe/ URLs are then read as they are; an image given as a whole URL must be under your origin.
  4. Re-sign any signed URLs with a key from the console: a Thumbor security key cannot be checked here. Or rewrite each URL with the table below.

Thumbor parameters, and what to use here

Thumbor ZawCloud Notes
WxH w, h 0 leaves that side to follow the other.
WxH without fit-in fit=cover Crops to fill the box, as Thumbor does.
fit-in fit=contain Never enlarges.
fit-in with filters:fill() fit=pad, bg A colour; fill(blur) and fill(auto) have no equivalent.
-WxH, Wx-H flip h, v or hv.
AxB:CxD crop x,y,w,h in pixels of the original, rather than two corners.
left, right, top, bottom fp A point: left/top is fp=0,0.
smart ai_crop With the AI add-on. Crops around the most salient subject.
trim trim, trimtol
filters:quality() q q=auto picks the lowest quality that still measures as the same image.
filters:format() f f=auto negotiates AVIF, then WebP, from the Accept header.
filters:blur() blur 0 to 100.
filters:grayscale() grayscale
filters:brightness(), filters:contrast() bri, con −100 to 100.
filters:rotate() rotate Multiples of 90.
filters:sharpen() sharpen On or off, without a strength.
filters:round_corner() radius One radius; the corners become transparent.
filters:strip_exif(), filters:strip_icc() strip Metadata is removed by default.
filters:watermark() overlay, opos, oopacity, osize The overlay is a path at the same origin, placed in a corner or the centre.
/meta/ info Size, colours and both placeholder hashes as JSON, in a different shape.
HMAC-signed URLs sig, exp, kid Signed with a console key, with an expiry.

Every parameter in the ZawCloud column is described in the API reference. The Thumbor names are as its public documentation gives them; if one no longer matches, tell us.

What has no equivalent here

  • Storage and result storage you run yourself: this edge keeps its own cache.
  • full-fit-in and adaptive-fit-in.
  • Filters such as noise, rgb, equalize, curve and the focal() hint.
  • Enlarging past the original's size, as upscale() does.
  • Output that moves.

Try it on your images first

The free tier is enough to point at your origin and compare the two side by side.

Other guides: imgix and Cloudinary and Cloudflare Images .