Migration from Imgix to ImageKit.io

If you are using Imgix, migrating to ImageKit.io is straightforward and can be done without changing your existing URLs. This guide will help you understand the steps to migrate from Imgix to ImageKit.io.

Step 1: Configure external storage

ImageKit supports all external storage that Imgix supports. That means you can easily configure existing storage in ImageKit. Refer to configure external storage and follow the integration steps based on your storage.

Step 2: Enable Imgix URL rewriter

Open URL endpoints in the dashboard, and enable "URL rewriter" in the desired URL endpoint under the "Advanced settings" tab, and select "Imgix" from the dropdown. This will parse the incoming URL transformations to the format that ImageKit understands. This allows you to keep the existing Imgix transformations in your application and still use ImageKit for media optimization, transformation, and delivery.

Step 3: Test and make the switch

Now, you should be able to access existing assets through ImageKit. At the same time, existing Imgix transformations should work without any changes.

Let's fetch an image without any transformation. The same would work for other file types as well.

Original image through Imgix (old URL)
https://example.imgix.net/rest-of-the-path.jpg
The same image using ImageKit.io URL endpoint
https://ik.imagekit.io/your_imagekit_id/rest-of-the-path.jpg

Let's see if transformations work as expected. The same would work for videos as well.

Imgix transformation (old URL)
https://example.imgix.net/rest-of-the-path.jpg?w=100
With ImageKit
https://ik.imagekit.io/your_imagekit_id/rest-of-the-path.jpg?w=100

Refer to the Imgix URL rewriter specification for a list of supported transformations and how they are translated.

Once you are confident that ImageKit is serving your assets correctly, you can either:

If you use a custom domain on Imgix, then read more about setting up a custom domain on ImageKit for media delivery.
Otherwise, replace the imgix domain example.imgix.net in your URLs with ik.imagekit.io/your_imagekit_id.

Imgix URL rewriter specification

Imgix transformation	Example translation	Remarks
width	`w=100` → `w-100`
height	`h=100` → `h-100`
aspect ratio	`ar=2:3` → `ar-2-3` `ar=3:1` → `ar-3-1` `ar=2:4` → `ar-2-4`	Aspect ratio will only work when we provide either width or height (not both) and fit
crop	`crop=top` → `fo-top` `crop=top,left` → `fo-top_left` `crop=left,top` → `fo-top_left` `crop=faces` → `fo-auto`	Supported values: top left right bottom top,left top,right bottom,right bottom,left left,top right,top right,bottom left,bottom faces
fit	`fit=clip` → `c-at_max_enlarge` `fit=fill` → `cm-pad_resize` `fit=scale` → `c-force` `fit=crop` → `no mapping required` `fit=fillmax` → `cm-pad_resize` `fit=max` → `c-at_max` `fit=facearea` → `fo-face`	Supported values: clip crop fill fillmax max scale facearea
fill		Supported values: solid
format	`fm=jpg` → `f-jpg`	Supported values: jpeg → jpeg jpg → jpg jp2 → jpg png → png webp → webp gif → gif avif → avif png8 → png png32 → png
quality	`q=60` → `q-60`
orient		Supported values: 1 → 0 6 → 90 3 → 180 8 → 270 0 → 0 90 → 90 180 → 180 270 → 270
fill-color	`fill-color=red` → `bg-red` `fill-color=BLUE` → `bg-blue` `fill-color=AAAA54` → `bg-AAAA54` `fill-color=A9AAAA54` → `bg-AAAA5466` `fill-color=B4F` → `bg-BB44FF` `fill-color=9B4F` → `bg-BB44FF60`	Color values are case-insensitive
bg	`bg=red` → `bg-red` `bg=BLUE` → `bg-blue` `bg=AAAA54` → `bg-AAAA54` `bg=A9AAAA54` → `bg-AAAA5466` `bg=B4F` → `bg-BB44FF` `bg=9B4F` → `bg-BB44FF60`	Color values are case-insensitive
dpr	`dpr=3.0` → `dpr-3.0`
sharp	`sharp=10` → `e-sharpen-200` `sharp=100` → `e-sharpen-2000`	The final result produced by ImageKit could differ from the result obtained from Imgix.
con	`con=30` → `e-contrast` `con=-50` → `e-contrast`	The final result produced by ImageKit could differ from the result obtained from Imgix.
usm	`usm=40` → `e-usm-2.5-8.00-1-0.05`	The final result produced by ImageKit could differ from the result obtained from Imgix.
usmrad	`usm=-50&usmrad=2` → `e-usm-2-0.00-1-0.05`	usmrad only works in conjunction with usm The final result produced by ImageKit could differ from the result obtained from Imgix.
blur	`blur=100` → `bl-5.00` `blur=90` → `bl-4.50`	The final result produced by ImageKit could differ from the result obtained from Imgix.
trim	`trim=auto` → `t-true` `trim=color` → `t-true`	The final result produced by ImageKit could differ from the result obtained from Imgix.