Imgix Compatibility
Yes. Small Pics has a built-in Imgix compatibility mode that translates Imgix query parameters automatically. Enable it on any image source and most existing URLs work without changes.
This means many sites can switch from Imgix to Small Pics without rewriting a single URL. Point your DNS at Small Pics, enable Imgix compatibility on the image source in the dashboard, and your existing Imgix URLs keep working.
Which Imgix parameters does Small Pics support?
| Imgix | Small Pics | Status | Notes |
|---|---|---|---|
bg | bg | ✅ | |
border | border | ✅ | |
pad | border | ✅ | Maps to border=<pad>,<bg>,shrink. Transparent
background if bg is not set. |
bri | bri | ✅ | |
con | con | ✅ | |
crop | fit | 🟠 | See crop mapping below. |
dpr | dpr | ✅ | Small Pics max is 8, Imgix max is 5. |
fit | fit | ✅ | See fit mapping below. |
flip | flip | ✅ | hv in Imgix maps to both in Small Pics. |
fm | fm | 🟠 | Small Pics supports: avif, webp, jpg, pjpg, png, gif, jxl. |
gam | gam | ✅ | See gamma mapping below. |
h | h | 🟠 | No relative sizes yet. |
w | w | 🟠 | No relative sizes yet. |
mark | mark | 🟠 | Relative URLs only. Images can be in different origins. |
mark-alpha | markalpha | ✅ | |
mark-pad | markpad | ✅ | Imgix defaults to 5px. |
mark-align | markpos | ✅ | Comma-separated positioning. Both default to bottom-right. |
mark-h | markh | ✅ | Relative positioning maps to <value>h. |
mark-w | markw | ✅ | Relative positioning maps to <value>w. |
mark-x | markx | ✅ | Relative positioning maps to <value>w. |
mark-y | marky | ✅ | Relative positioning maps to <value>h. |
mark-fit | markfit | ✅ | See markfit mapping below. |
orient | or | ✅ | EXIF values mapped. See orientation mapping below. |
q | q | ✅ | |
sharp | sharp | ✅ |
How do fit values map between Imgix and Small Pics?
| Imgix | Small Pics |
|---|---|
clip (default) | contain (default) |
max | max |
fillmax | fill |
fill | fill-max |
scale | stretch |
clamp | cover / crop |
facearea | Not supported |
min | Not supported |
Focal point cropping
When crop is "focalpoint" and fit is "crop", Small Pics maps fp-x, fp-y, and fp-z to fit=crop-<x%>-<y%>-<zoom>.
Directional cropping
When crop is set to a directional value, it maps to fit=cover-<value>:
| Imgix | Small Pics |
|---|---|
top | cover-top |
bottom | cover-bottom |
left | cover-left |
right | cover-right |
left,top | cover-top-left |
bottom,left | cover-bottom-left |
right,top | cover-top-right |
bottom,right | cover-bottom-right |
How does gamma mapping work?
| Imgix | Small Pics |
|---|---|
| 1 to 100 | 0.1 to < 1.0 |
| -1 to -100 | 1.0 to 9.9 |
How does orientation mapping work?
Small Pics does not use EXIF values directly. Imgix EXIF orientation values are mapped
to Small Pics or and flip parameters.
| Imgix | Orientation | Flip |
|---|---|---|
2 | - | h |
3 or 180 | 180 | - |
4 | - | v |
5 | 90 | h |
6 or 270 | 270 | - |
7 | 90 | v |
8 or 90 | 90 | - |
default / 0 | 0 | - |
How do watermark fit values map?
| Imgix | Small Pics |
|---|---|
clip (default) | contain (default) |
max | max |
crop | cover |
scale | stretch |
How does watermark positioning map?
Imgix mark-align | Small Pics markpos |
|---|---|
top | top-right |
middle | right |
bottom | bottom-right |
left | bottom-left |
center | bottom |
right | bottom-right |
left,top | top-left |
left,middle | left |
bottom,left | bottom-left |
center,top | top |
center,middle | center |
bottom,center | bottom |
right,top | top-right |
middle,right | right |
bottom,right | bottom-right |
Frequently asked questions
- Can I switch from Imgix to Small Pics without changing my URLs?
- Yes. Enable Imgix compatibility mode on your Small Pics image source and most existing Imgix URLs work without changes. Small Pics translates Imgix query parameters to their equivalents server-side.
- Which Imgix parameters does Small Pics support?
- Small Pics supports most core Imgix parameters: w, h, dpr, fit, crop, fp-x, fp-y, fm, q, sharp, bri, con, gam, flip, orient, bg, border, pad, and the full set of watermark parameters (mark, mark-alpha, mark-pad, mark-align, mark-h, mark-w, mark-x, mark-y, mark-fit).
- Which Imgix parameters are NOT supported?
- fit=facearea and fit=min are not supported. Relative sizes for w and h are not yet supported. The mark parameter only supports relative URLs. All other core transform parameters are covered.
- How do I enable Imgix compatibility mode?
- In the Small Pics dashboard, open your image source settings and enable Imgix compatibility. Once enabled, any request using Imgix query parameters is automatically translated.
- Does any other image service offer Imgix parameter compatibility?
- Gumlet offers partial Imgix API compatibility. Small Pics and Gumlet are the only two services in the market with built-in Imgix parameter translation. No other major provider (Cloudinary, ImageKit, Cloudflare Images, Bunny, ImageBoss) supports Imgix parameters.
- Can I use Imgix compatibility mode with the Imager X plugin?
- You can, but you do not need to. The Imager X transformer plugin uses native Small Pics parameters directly. Imgix compatibility mode is most useful for sites that have Imgix URLs hardcoded in templates, a CMS, or a database.