Migrating from imgix.video to Imgix Video

Video delivery is consolidating onto imgix.net — the same domain that already powers your Imgix images. If you’re currently serving video through an .imgix.video subdomain, this guide walks you through moving to Imgix Video before the cutover date. For most accounts, migrating is a simple one-step subdomain change. If you use any imgix.video-specific parameters, a few of them need to be translated to their Imgix Video equivalents.

What you get on Imgix Video

Once you’re on imgix.net, you can do more with your video than imgix.video ever offered — all from the URL:

AI-generated subtitles and overlay text — transcribe your video’s audio and translate it into multiple languages, with customizable caption styling
Video previews — Imgix automatically selects the most representative moments from your video and compiles them into a short, engaging preview
Enhanced quality encoding — set a perceptual quality target and let Imgix find the smallest file that meets it, so viewers get consistent quality at lower bandwidth
Audio controls — denoise, normalize loudness, fade in and out, adjust volume, or mute, without re-editing your source files
Frame interpolation — AI-generated intermediate frames for smooth slow motion and higher frame rates, even from low-fps source footage
Picture-in-picture — overlay a second video for “up next” previews, reaction clips, or multi-camera views

Because video runs on the same platform as your images, you get one workflow for every visual asset.

Prerequisites

Before you start, make sure you have:

Access to wherever your video URLs are generated or hardcoded (your codebase, CMS, or CDN configuration)
A list of every .imgix.video subdomain your account uses (including any dev/staging/prod variants)

Find every `.imgix.video` reference

Search your codebase, CMS, or templates for the .imgix.video domain string. Migrate every subdomain you find — some accounts use multiple (for example, separate subdomains for production and staging).

Swap the subdomain

Replace .imgix.video with .imgix.net in each URL. The path and every query parameter stay exactly the same:

Before: https://your-subdomain.imgix.video/path/to/video.mp4?fm=mp4
After:  https://your-subdomain.imgix.net/path/to/video.mp4?fm=mp4

All standard rendering parameters — w, h, fit, auto, q, fm=mp4, and so on — are identical on Imgix Video and require no changes.

Translate any imgix.video-specific parameters

If your video URLs use any of the following imgix.video-specific parameters, translate them to their Imgix Video equivalents:

imgix.video parameter	Imgix Video equivalent
`video-generate=thumbnail` + `video-thumbnail-time=N`	`video-thumbnail=N` + `fm=jpg`
`res=low` / `res=medium` / `res=high`	`w=720` / `w=1280` / `w=1920`
`video-generate=storyboard` + `video-storyboard-format=<fmt>`	`fm=spritesheet` + `video-spritesheet-format=<fmt>`
`video-generate=gif` + `video-gif-fps=N` + `video-gif-start`/`video-gif-end`	`video-generate=gif` + `fps=N` + `video-clip-start`/`video-clip-end`
`vdl`	`dl=filename` — forces a download and lets you specify the downloaded filename
`gif-q`	`q` — same 1–100 quality scale

If you don’t use any of these parameters, you can skip this step — a plain subdomain swap is all you need.

Review a few behavior notes

A couple of things to be aware of as you test your migrated URLs:

HLS delivery: fm=hls is fully supported on Imgix Video — no special access is required.
Video length: videos up to 30 minutes are supported.
Longer videos process asynchronously: videos longer than two minutes are encoded in the background. The first request to a new URL returns a 423 status while the video is prepared; subsequent requests serve the finished video from cache. This is expected, not an error — poll the URL or check again after a few minutes.

Test before cutover

Request each migrated URL and confirm you get a 200 response (or the expected 423 on a first request). Compare the output — dimensions, format, thumbnail frame — against the original imgix.video URL to confirm it matches.

Deploy

Once you’ve verified your migrated URLs, roll the subdomain swap out to production. .imgix.video URLs will stop resolving after the sunset date, so confirm no cached or stale references remain anywhere in your stack.