Coming from Cloudinary

Moving from Cloudinary

Cloudinary keeps uploaded copies of your images; this edge fetches them from your own origin. The transformations map closely, from path segments to query parameters.

What is different

Cloudinary's upload delivery serves copies you uploaded to it, and writes transformations into the path, such as /w_800,c_fill/. This edge has no upload: it fetches each image from an origin you run, and takes the same instructions as query parameters. Its fetch delivery type is the closest match. If your originals exist only in Cloudinary, export them to storage you host first.

Moving, step by step

  1. Make sure your originals are at an HTTPS origin you control, exporting them from Cloudinary if that is the only copy.
  2. Create an account and set that origin.
  3. Rewrite each delivery URL: the public id becomes the path, and each transformation becomes a query parameter from the table below.
  4. Turn named transformations into presets in the console, and re-sign any signed URLs with a key from it.

Cloudinary parameters, and what to use here

Cloudinary ZawCloud Notes
w_, h_ w, h
w_auto, dpr_auto w=auto, dpr=auto Both read the browser's client hints.
f_auto f=auto AVIF, then WebP, from the Accept header.
q_auto q=auto Picks the lowest quality that still measures as the same image, per image.
c_fill fit=cover
c_fit, c_limit fit=contain Never enlarges, like c_limit.
c_scale with both sizes fit=fill Stretches to the box.
c_pad, b_ fit=pad, bg
c_crop with x_, y_ crop x,y,w,h in pixels of the original.
g_auto ai_crop With the AI add-on. Without it, fp keeps a point you choose in frame.
g_face, g_faces ai_crop=face With the AI add-on.
a_90, a_180, a_270 rotate Multiples of 90 only.
a_hflip, a_vflip flip h, v or hv.
e_brightness, e_contrast, e_saturation bri, con, sat −100 to 100.
e_gamma gam A factor from 0.1 to 10, where 1 is unchanged.
e_blur blur 0 to 100, so values need rescaling.
e_sharpen sharpen On or off, without a strength.
e_grayscale grayscale
e_trim trim, trimtol
r_ radius
r_max mask=circle
bo_ border width,colour: bo_4px_solid_red is border=4,ff0000.
l_text: watermark, wmpos, wmopacity Placed in a corner or the centre.
l_ with an image, o_ overlay, opos, oopacity The overlay is a path at the same origin, not a public id.
fl_keep_iptc strip=false Metadata is removed by default here too.
e_background_removal ai_remove_bg With the AI add-on.
e_upscale ai_upscale 2x or 4x, with the AI add-on.
e_improve ai_enhance With the AI add-on.
t_ (named transformation) preset Defined in the console.
s--signature-- sig, exp, kid Signed URLs here also carry an expiry, and must be re-signed.

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

What has no equivalent here

  • Uploading and storing images, and the media library.
  • Video, and output that moves.
  • Chained transformations, applied one after another.
  • Gravity by compass direction, such as g_north. fp takes a point instead.
  • Text in a chosen font and size.

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