imgix Changelog Cover Image

Here you can stay up to date with the latest improvements, new features, and updates to our services and libraries. We are committed to continuously enhancing our platform to better serve your image processing and optimization needs. Check out what's new and how we are working to provide you with the best possible experience.


Background Replacement

Removing a background from an image has been available for premium customers for months. Now, we are adding the ability to remove the background and optionally replace it with a new background generated from a prompt. Using a positive prompt and an optional negative prompt, a new background for your image will be generated. See our documentation for more info. If you’d like this feature enabled, please reach out to your account manager or contact us (opens in a new tab).

AI-based Video Captions

For all video customers, you can now include automatically generated captions in a preconfigured language of your choice. When using the imgix video player (opens in a new tab) and most other modern video players, the captions will be available for your customers to view alongside playback. See our documentation for more info.

AI-based Alt Text Generation in Beta

When enabled on a premium plan, we will process your image assets to include an automatically generated caption of the image’s visual content. This new metadata can be used in many places, but our goal is to improve web accessibility and searchability by making it easy to include an alt attribute with all of your images. You can access the generated image caption from the Management API and in Asset Manager when viewing asset details and when copying an embed code. See our documentation for more info. To enable this feature, please reach out to your account manager or contact us (opens in a new tab).

Gradient Fill

A new fill mode has been added to fill excess space with a gradient color when using fit=fill or fit=fillmax on a resized image. By default, the gradient will use a combination of the vibrant dark and vibrant light colors sampled from the image’s color palette, but you can customize the color controls with a set of new fill-gradient-* parameters. See our documentation for more info.

Enhanced GIF Compression

We’ve made improvements to our GIF render pipeline to both encode the output file faster and produce smaller file sizes. This rollout will automatically improve all GIF outputs and works in tandem with the animated GIF quality (gif-q), quality (q), and auto=compress parameters.

Other Features and Fixes:

  • You can now delete any unwanted Source directly from the Dashboard. This is helpful to stay within your plan limits or simply to clean up your workspace. Note: This is an irreversible action.
  • With advanced reporting enabled on your account, you can now download your data directly from the Dashboard in addition to the previously available endpoints in our Management API.
  • We’ve increased the default rate limits for our Management API by 4x. See our documentation for more info.
  • For the safety and security of the internet, all SVGs delivered through our render stack will now be sanitized to remove any scriptable contents.
  • Image embed codes copied from Asset Manager will now include the loading="lazy" and fetchpriority="high" attributes.
  • We’ve improved our origin image caching system to not require a secondary request to your origin on a cache fill. Some customers were experiencing increased egress usage from their origins.
  • Improvements have been made to face detection performance, accuracy, and the final bounding regions of the detected faces.
  • We’ve improved the encoding speed of the WebM output format by up to 4x, and we have improved the encoding speed of animated WebP outputs with more than 50 frames by up to 2x.


Image Outpainting With fill=generative

Generative Fill marks a significant advancement in imgix's image transformation capabilities, enabling users to extend and fill images with context-aware AI. We are excited to introduce several new Generative Fill parameters that will allow you to outpaint and enhance the versatility of your images:

  1. Customize aspect ratios — Adapt your images to an aspect ratio that fits your platform requirements and apply the fill to generate pixels that complete the picture with fit=fill&fill=gen&ar=x:y.
  2. Adjust your focal point — Position the focal point of your image where you want it on the canvas with fill-gen-pos.
  3. Generate with prompts — Guide the output of the fill with prompts with fill-gen-prompt and fill-gen-neg-prompt.
  4. Achieve consistent results — Use seed values to achieve consistent results or explore variations without altering your original vision with fill-gen-seed.

Additionally, you can transform your images with Generative Fill within the Image Editor in the imgix Dashboard. See our documentation to learn more about how you can use this feature.

Generative fill is currently available for imgix customers on certain plans. If you’re interested in this feature, please contact our sales team (opens in a new tab) or your Account Manager to get more information on this feature.

Using auto=format as a Default Parameter

With recent technological advancements, it's become easier to move business logic closer to our end-users, specifically into CDN edge nodes. As such, we're excited to now offer the ability to set auto=format as a default parameter for all customers on a paid plan. You can use the imgix Management API or Dashboard Source Configuration (opens in a new tab) to update your default parameters.

Origin Request Authentication

We have expanded your options to aid in identifying requests to your origin server coming from imgix. For Web Folder and Web Proxy Sources you can configure one or more of the following:

  1. Basic Authentication — Set a username and password that will be sent in an Authorization request header.
  2. Handshake — Set a handshake secret that will be delivered in an X-Imgix-Origin-Secret header.
  3. Request Signing — Set a signing key that will be used to deliver time-based signatures in a series of X-Imgix-Signature request headers.

See our documentation for more details on how to use this new feature with your Web Folder or Web Proxy sources, and a better understanding of when you might use one option over another. We will deliver future communication around how these new options will replace IP allow listing.

Note: For all S3, GCS, Azure, and S3-compatible source types the read credentials supplied during Source setup are enough to ensure restricted authorized access to your origin buckets.

Other Features and Fixes

  • The imgix Rendering API now supports using the AVIF file type as an input.
  • Asset Refresh has long existed in the imgix Management API, and can now be triggered within Asset Manager (opens in a new tab). Refreshing will force a reprocess on a specific asset in your origin to ensure any modifications or deletion takes effect.
  • Expanded our "Load to Encode" video processing to trigger on requests for thumbnails and storyboards in addition to video playback.
  • We’ve updated our HTTP response codes to better distinguish between imgix errors and customer origin errors. The new 424 response status will indicate that imgix is having an issue accessing the requested origin asset, most likely indicating an issue with the customer’s origin. Any 5xx error will indicate an imgix internal issue.
  • Fixed an issue that was causing some inconsistent output when using crop=focalpoint.
  • Updated support for SVGs that contain inline <image> tags.
  • Fixed an issue with using rect and upscale simultaneously.


Video Support for Microsoft Azure and Web Folder Sources

Microsoft Azure and Web Folder Sources can now be used with the imgix Video API (opens in a new tab). For customers with video enabled, video assets discovered in an Azure or Web Folder origin will be processed (opens in a new tab) and available for playback on the Source's imgix Video domain (opens in a new tab).

If you'd like more information on how to add video capabilities to your imgix plan, please contact us at

Asset Manager Support for Web Folder Sources

Web Folder assets delivered via the imgix Render API (opens in a new tab) will now be processed and available in Asset Manager (opens in a new tab) where you can browse, search, and tag your origin images. See our documentation (opens in a new tab) to read more about Asset Manager and how it can fit into your asset management workflows.

Updated Image Enhancement Algorithm

auto=enhance (opens in a new tab) is switching to a new contrast limited adaptive histogram equalization (CLAHE (opens in a new tab)) algorithm. The core mission for image enhancement is to create a more vibrant, engaging, and better-looking image. We believe this change creates better enhancements today, and gives us a platform to further improve images automatically in the future.

Other Features and Fixes

  • The txt-lig Render API parameter is deprecated.
  • Fixed an issue that prevented some assets from being refreshed if there was a Source prefix configured.
  • Fixed an issue where some users with billing permissions were not receiving invoice updates via email.


Video Encoding on Playback

For video customers, our new "Load to Encode" (opens in a new tab) functionality makes working with your videos even easier. When a previously unprocessed video is requested for the first time we will automatically start encoding it for optimized playback. While encoding, you will see a 423 HTTP Response from our servers to notify you that the video is processing. Once encoding has completed, the video will begin normal playback on any subsequent request.

Additionally, we've built this functionality into the imgix video player, ix-player (opens in a new tab). The video player will automatically handle the new processing flow, and begin playback of the video once available.

If you'd like more information on how to add video capabilities to your imgix plan, please contact us at

Other Features and Fixes


AI-Powered Super Resolution for Images

We've released a new upscale parameter to our Rendering API that uses AI to increase an image's resolution, making it sharper, clearer, and more visually striking. As a result, images can be displayed much larger without the typical pixelation artifacts.

imgix AI-Powered Super Resoltuion

For more details, please check out our documentation (opens in a new tab). If you are an existing Enterprise customer, please reach out to your dedicated Account Manager to enable Super Resolution. If you are not an Enterprise customer yet, please contact us at to get access to this feature.

Other Features and Fixes

  • You can now update or remove your stored origin upload credentials (opens in a new tab) from within your Source's configuration page in the imgix Dashboard. Upload credentials allow you to upload assets to your supported Source's origin bucket from within the imgix platform.
  • We fixed some small bugs that would prevent customers on Legacy subscription plans from updating to our current plan offerings within the imgix Dashboard.
  • Patched a libwebp vulnerability (CVE-2023-4863 (opens in a new tab))
  • Patched a DDOS vulnerability involving HTTP/2 protocol (CVE-2023-44487 (opens in a new tab))


Improved Source Deploy Infrastructure

We've made several improvements to our Source deploy infrastructure that allow new Sources and edits to existing Sources' configuration to be deployed and take effect in seconds rather than minutes.

Other Features and Fixes

  • We are deprecating new Web Proxy Source types for standard plan customers. All existing Web Proxy sources will continue to work regardless of plan type. To inquire about creating new Web Proxy source types, contact our support team:
  • We will now send an email to all account users with Billing permissions when an invoice is unpaid beyond its due date.
  • Fixed issues with font rendering when using the txt-line-color parameter and txt-font parameter with multiple values.
  • Fixed an edge case issue when using the duotone parameter.


Asset Manager Add API

The /add endpoint queues an asset from your origin to be added to Asset Manager. This new endpoint is useful if your asset upload and management workflows do not use the imgix Dashboard UI or Upload APIs, or if you are not relying on imgix to regularly crawl your origin for new assets.

See the docs (opens in a new tab) for more information.

Other Features and Fixes

  • Refreshing an asset that has been deleted at the origin now removes it from Asset Manager as expected.
  • Fixed an issue where some video analytics were not properly attributed in Dashboard.
  • Fixed an issue where invalid values for fit=fill and fill-color would result in an unexpected image aspect ratio.
  • Fixed a decoding issue with CMYK JPEG images that would render incorrectly in some circumstances.


Cloudflare R2 Source Type

We've added support for integrating with your Cloudflare R2 storage bucket when creating a new Source. Using the Cloudflare R2 Source type has all of the same advantages as our other S3-compatible Source types, including better asset privacy and security. Read the documentation for Cloudflare R2 Source creation (opens in a new tab) or migrate an existing Web Folder Source (opens in a new tab).

Expanded Background Removal Image Support

Images larger than 12MB or 50 megapixels will now be optimized for background removal by default. See the announcement blog (opens in a new tab) or read our docs (opens in a new tab) for more details on how to use the bg-remove parameter. To get started, contact our sales team:

Other Features and Fixes

  • For accounts with past due invoices, you will see a persistent banner and list of invoices in Dashboard as a reminder to submit payment.
  • The imgix render API will return a 402 HTTP response code, previously 512, when your account's renders have been disabled for either billing or overage related reasons.
  • You will be prevented from modifying your plan until your account's billing status is returned to normal.


Background Removal Fallbacks

The imgix background removal render API (opens in a new tab) now supports graceful failures by default. Not all images are prime candidates for background removal and by using the bg-remove-fallback parameter (opens in a new tab) you can control what happens in those cases. We've also added a new response header X-Imgix-Bg-Remove-Failure-Reason to give more feedback as to why a requested images's background removal failed.

If you're interested in testing background removal with your sources, contact our sales team:

File Downloads via Video API

Using the vdl parameter (opens in a new tab) with the imgix video API will force the browser to download the video file instead of play it back. The value set for the parameter will be the filename of the downloaded video file, default is the original name.

Other Features and Fixes

  • Added new entries to our list of IP ranges (opens in a new tab), which are used to fetch assets from origins.
  • Asset categories and custom fields now support the full range of allowable UTF-8 characters so you can add, edit, and search in any language.
  • Fixed a bug where certain animated image files would fail to render as AVIF.


Background Removal

The imgix render API now supports image background removal and replacement. See the announcement blog (opens in a new tab) or read our docs (opens in a new tab) for more details on how to use the new bg-remove parameter. Once enabled, you can easily see how background removal can work for your images in Asset Manager. To get started, contact our sales team: background removal image

Expanded Usage Notifications

We've improved how and when we notify you that your account is reaching your included plan limits, such as origin images and bandwidth. You will receive emails and Dashboard messages beginning at 50% usage, and we will recommend how to proceed if you think you might reach your plan's limit. Please note, we reserve the right to disable your service if you significantly exceed your plan limits.

Other Features and Fixes

  • You can now select from up to 300 categories, increased from 30, when categorizing assets in Asset Manager.
  • Images sent to our auto-tagging service are limited to 500MB for system stability and reliability.
  • Fixed a bug with AVIF files larger than 7000px wide.
  • Fixed a bug that would prevent setting default and error images on a Source.


Japanese Characters in Categories and Custom Fields

Asset Manager supports the use of Japanese characters for categories and custom fields. See Asset Manager (opens in a new tab) docs for more on how to add, search, and manage your assets' metadata.

Additional AWS S3 Regions

imgix supports AWS S3 buckets created in the following regions:

  • af-south-1 Africa (Cape Town)
  • ap-south-2 Asia Pacific (Hyderabad)
  • ap-southeast-3 Asia Pacific (Jakarta)
  • ap-southeast-4 Asia Pacific (Melbourne)
  • eu-south-1 Europe (Milan)
  • eu-south-2 Europe (Spain)
  • eu-central-2 Europe (Zurich)
  • me-central-1 Middle East (UAE)

More Emojis in txt Parameter 🥷

We've updated our emoji font to support the latest v14 characters (opens in a new tab) when using the txt parameter (opens in a new tab).


Background Removal Available in Beta

  • A new background removal API is available in limited release for our Enterprise customers. Reach out to your Account Manager if you would like to test this new feature.

Support for Digital Ocean, Linode, and Wasabi

Thumbnails for Video

New ix-player Video Player

  • We listened to your feedback and re-architected our video player to split the core of the player and the player itself into two packages.
  • ix-video is now a slimmed-down wrapper on top of the built-in <video> element with HLS support and a much smaller download size.
  • ix-player has all of the bells and whistles of a fully-featured video player, including built-in support for our new thumbnail, GIF preview, and storyboard feature set.
  • You can check out a demo of the new packages on our video solutions (opens in a new tab) page or on GitHub (opens in a new tab).

Added New Japanese Font Options

Bug Fixes

  • Fixed an issue where some large AVIFs were not rendering correctly.
  • Fixed an issue where some corrupt images were not rendering correctly.


React Native Tutorial

  • See how simple it is to use imgix in your React Native applications with our new React Native Guide (opens in a new tab). This tutorial will teach you how to resize an image automatically to fit device dimensions, update image resolution automatically to match device DPR, and other tips to keep your app performant.

video.js Plugin Support

New Wordpress Plugin

More Flexible Encoding in js-core


Uploads in Asset Manager

New Video Analytics

  • Visualize how many videos and minutes are streamed and encoded on a daily basis with new video analytics in Dashboard. You can learn more about our Video API here (opens in a new tab).

Other Features and Fixes


Image Manager Is Now Asset Manager

New Upload Sessions API

  • We have added an upload sessions flow (opens in a new tab) that support uploads up to 5GB. This is a multi-part, sequential flow that involves creating a session, uploading a file for that session, and finally closing the session. Note: This is currently supported only for Amazon S3 and Google Cloud Storage Sources.

Other Features and Fixes

  • Fixed a performance issue impacting a small percentage of image rendering requests.


Video Playback in Image Manager

More Flexible Text Positioning

Image Manager Simple Search Now Includes Custom Fields

Bug Fixes

  • Fixed an issue where auto=format (opens in a new tab) was not correctly returning WebP images for some Edge browsers.
  • Various bug fixes for Image Editing within Image Manager.


New Salesforce Commerce Cloud Integration

New Magento (Adobe Commerce) Plugin

Added Inclusion and Exclusion Paths to Image Manager

  • Now you can configure your Source to include or exclude certain paths from asset discovery in Image Manager. This does not affect which assets can be rendered via imgix, only which assets are eligible to appear in Image Manager.


Video Now In Limited Availability

Performance Improvements

  • Released upgrades to our image processing resulting in up to 20% faster average render times and up to 34% faster average render times for certain file formats.


Log4j Update

  • We would like all of our users to know that imgix does not use Log4j in any of our services so we are not impacted by the recently publicized exploits. As always, we are continuously monitoring our services and staying up to date with security best practices.

Bug Fixes

  • Fixed a bug where some Purge API requests would intermittently return a 401 Unauthorized error.


New Contentful App Available

AVIF and auto=format


AVIF For auto=format Now In Limited Release

Bug Fixes

  • Various bug fixes for minor display issues in Dashboard.


New Beta Feature: IPTC Metadata Passthrough

  • We are currently beta testing preserving IPTC metadata on rendered JPGs. If you would like this enabled on your account, contact your Account Manager or Support (opens in a new tab).

Switch From Legacy To New Pricing

  • Customers can now switch their billing plan from our legacy plan to one of our new pricing plans. Previously this required contacting our Support team. You can read more about our new pricing plans here (opens in a new tab).

Bug Fixes

  • Various bug fixes for minor display issues in Dashboard.


Increased Render Input Size

  • We have increased the cap on input images for Enterprise customers (by default it is 500MB). Contact your Account Manager or Support (opens in a new tab) to get it enabled for your account.

Only Enabled Sources Count Toward Source Limits

  • Previously, all Sources (whether enabled or not) would count toward account Source Limits.

Bug Fixes

  • Fixed an issue with the Dashboard signing tool that was not accepting certain characters.
  • Reduced the number of network calls for account and plan information, resulting in faster Dashboard load times.


Use Aspect Ratio Param With fit=fill

Bug Fixes


fm=avif Now In Limited Release

  • After many tests and performance analyses we are excited to announce that fm=avif is now available in limited release. Contact support (opens in a new tab) if you would like to have it enabled for your Sources.
  • This change does not include returning AVIF files for auto=format until further performance testing informs when auto=format should return AVIF.

New Notifications Available in Dashboard

  • Stay up to date with your Image Manager uploads, account invoices, and more with the Notifications view (opens in a new tab). New notifications will also trigger the notifications icon to light up in the Dashboard header.

Path Encoding Fixes


Support For gatsby-plugin-image (opens in a new tab)

Support For HEIC Uploads

  • Image Manager now supports uploading HEIC files via the Image Manager UI. Previously this was only available via the API.

Image Manager Bug Fixes

  • Fixed wrong content type for some video files.
  • Fixed asset refresh behavior on directories.


Support For BlurHash (opens in a new tab)

New Gatsby Plugin

Bug Fixes


New Angular Library Released

Legacy API Keys Removed

New PDF Param pdf-annotations

  • We have upgraded our PDF rendering and it is now possible for PDF renders to show annotations. The parameter pdf-annotation (opens in a new tab) controls whether to show or hide the annotations.

Bug fixes

  • Fixed a bug which prevented valid hostnames from being used as Web Folder Base URLs
  • Fixed a bug in Dashboard which prevented some accounts from using the Purge tool.


New parameters for uneven border and pad

blend and watermark can now be scaled by relative size

Bug Fixes

  • Fixed a bug in the Signing Tool (opens in a new tab) that was causing some base64-encoded parameters to be improperly signed.
  • Bug fixes and improvements to the imgix Dashboard.


New Vue Library

Custom srcset Generation Available Across All Core Libraries

crop (opens in a new tab) Now Supports Fallback to focalpoint

New transparency Parameter

New Edge Nodes Available in Milan and Palo Alto

Bug Fix

  • The imgix Dashboard now shows more specific error messages when encountering S3 Source validation errors.


We are excited to reintroduce the imgix Changelog! Moving forward we will be publishing a monthly changelog that includes all user-facing product changes. Thanks and stay tuned!

Audience Analytics & More

New docs for expires

PDF invoices

  • Customers can now receive their invoices as a PDF attachment.

Bug fixes

  • Corruption on certain HEIC files has been addressed.
  • Fixed a bug where customers with more than 24 Sources could not see all of their Sources in their Dashboard.


New Vancouver Edge Node


SVG Bug Fixed

  • Due to a regression, SVG files without an XML declaration were not being detected properly and not served with the correct application/svg+xml Content-Type. A fix was deployed this week, so SVG files should now be served correctly.


Bug Fix

  • Fixed order of operations for palette so that it resizes/crops before generating the palette.


HEIC Support




  • Rearranged the Billing view (opens in a new tab) and added new editable fields so you can update information that appears on your invoices: VAT number, billing address, and PO number.
  • Fixed a bug on the invoice table that was causing invoices with totals of $0.00 to show up truncated.

New Edge Node

  • Added an additional Brazil edge node in Rio de Janeiro


Progressive JPEG

  • Re-enabled fm=pjpg support
  • Identified and fixed an issue where progressive JPEGs were being rendered at lower than expected quality


  • Fixed an issue with the trim parameter, which was removing 1 extra row of pixels on the right and bottom edges in some cases


  • Added an optional field for users to record their phone number in addition to their email address, to help us with account management.
  • Fixed a bug that was causing our requirements-checker to disallow mobile browsers from logging in.
  • Fixed a broken link to our docs on the support view (opens in a new tab).




Updated Caching Options

To make best practices for caching with imgix easier and clearer, we made a couple of changes:

imgix-core-js 1.0.6 (opens in a new tab)

  • Fixed a pair of bugs when signing URLs where the path component contained URL-encoded characters.


  • Fixed an issue with the URL signing tool where full URLs with query strings provided as the "path" component of the URL were getting their query strings appended to the resultant signed URL rather than encoded and signed properly.
  • Fixed a bug in the source editing & creation views where error messages were not being shown properly when submitting invalid S3 credentials.


  • Fixed font readability issues on Windows.



  • Fixed a bug that was preventing AWS credentials from being updated when re-enabling a source.



  • Fixed font rendering issues on Windows.
  • Added the ability to sign in directly on viewport widths <1050px. On viewport widths <480px, sign-in is only available in the dropdown menu.



  • The Source views, including the interfaces for creating, editing, and deploying Sources, have all been rebuilt from the ground up to be more intuitive, easier to use, and prettier.


imgix-core-js 1.0.5 (opens in a new tab)


  • Fixed an issue with the URL signing tool where URLs given as paths for web proxy Sources weren't being encoded properly.

Upcoming Source Deployment Upgrade

  • On 3/15 from 1-3PM PST, we will be upgrading our backend systems to improve Source deployments. The imgix dashboard will be unavailable during this time, but images will continue to serve normally.


imgix.js 3.2.0 (opens in a new tab)

  • Reworked configuration options to allow more options to be set via <meta> tag if desired.
  • Added ability to override any global configuration options by providing an options object when calling imgix.init().
  • Added option to disable auto-initialization with a <meta> tag.

Drift 1.2.0 (opens in a new tab)

  • Fixed some inconsistencies in package.json to solve some minor problems in certain build setups.

Shopify Guide

  • Due to issues with stale images, we're retiring our Shopify Integration guide. We hope to bring it back when we can offer a solution that more robustly integrates with Shopify.


Error Codes

  • imgix now returns a "403 Forbidden" error on signed images with an invalid s parameter instead of a "401 Unauthorized" error. Still a 4xx error, but more correct.



  • Added account type and optional features list to the Account view (opens in a new tab)
  • Upgraded the source "default parameters" field to check parameter values for validity, instead of just parameter names
  • Also, updated the list of legal parameter names to include some newer additions
  • Added validation to prevent user names from containing brackets






  • Updated the calendar navigation on the Analytics view (opens in a new tab) to work better for accounts with more than two years' worth of data.
  • Fixed a bug that sometimes caused the graphs & navigation on the Analytics view to not update correctly after the user finished scrolling or resizing their browser.
  • Fixed a rendering bug that was appearing in the Analytics graphs on Chrome 55 on at least one machine.
  • Fixed a pair of bugs that were causing Javascript errors when the user would navigate away from a view with a form while it was still initializing.
  • Adjusted the background color of our modal window when it overlays auxiliary pages.



  • Fixed a bug in our example widgets that was causing dropdown menus to be incorrectly populated.


  • Fixed broken documentation links for a handful of parameters.
  • Updated parameter list to include newer additions such as border-radius-inner and border-radius-outer.



  • Fixed the calendar navigation on the Analytics view to show only the last two years. Data from 2015 can still be accessed by clicking on the month name and using the dropdown menu.



  • Fixed some error messages on the sign-in form to be more helpful
  • Removed some outdated warning copy on the Analytics view
  • Tweaked the loading behavior for some components to be less herky-jerky
  • Fixed the spacing of form footers to be more consistent



  • Fixed a bug in the source-signing tool that was mangling user-provided query strings with more than one parameter.
  • Added some handy auto-focus behavior to a few forms that frankly, should have had this behavior from the start.
  • Made some minor spacing and layout improvements for forms on smallscreen devices.



New Masking and Border Options

  • Added rounded corners as an option for masking images (mask=corners), with the ability to round each corner and set the radius individually (corner-radius). Also added the maskbg parameter so you can apply a color to the masked area.
  • We also added rounding to our border parameter, again with individual controls for each corner and for the inner and outer radii (border-radius, border-radius-inner).

The upshot of these two changes is that adding these common display styles is now a lot easier with imgix. Thumbnails, avatars, and other types of images with simple border and mask requirements can now be created just by adding parameters to your existing images. Check out the border (opens in a new tab) and mask (opens in a new tab) documentation for more information and interactive examples.


  • Fixed a case-sensitivity bug in the parameter field on the source-signing view.
  • Made various sizing and leading tweaks to text styling in titles and modals.
  • Rolled out a major update to the checkmark icon in our checkbox inputs.

Open Source Libraries



  • Improved empty-state copy for dashboard and source list views to be more helpful to new users, and made some minor design improvements.
  • Fixed a bug that prevented users from accessing the rollback view under certain specific conditions.


New rect Options

  • Added relative methods of defining the start point for the cropping area of the rect parameter. It now accepts left, center, or right options for the x value, and top, middle, or bottom for the y value, in addition to accepting integer values. See the docs (opens in a new tab) for more information.


  • Updated our modal windows to match some of our fresher, hotter styles
  • Changed the color of the global overlay from dark to light, to cut down on rapid contrast changes (h/t Mr. Flintrup)

Open-Source Libraries


Open Source


  • Removed our old coupon redemption view. If you've been holding onto a coupon for years, now would be a great time to redeem it! Email us at with your coupon code and we'll help you out.
  • Fixed some spacing issues on the Tools view (opens in a new tab)
  • Rewired the Sign-In view a bit, but you probably won't even notice the difference.


New Color Space Options

  • Added two possible values for the cs parameter, which controls the color profile of the image. In addition to srgb (the Internet standard) and adobergb1998, cs now supports tinysrgb for the bare minimum color profile, or strip, which removes it altogether.

    These new options can help reduce file size for smaller images like thumbnails where the color profile information is a larger proportion of the total image weight. See the docs (opens in a new tab) for more information.

Open Source



  • As foretold in prophecy (opens in a new tab), the render_cache_ttl field has been completely removed from the Source view.
  • Fixed a bug that could cause the wrong user logo to be shown in the navigation bar.



  • Fixed a bug that caused the UI to begin deflating immediately and ungracefully when signing out, rather than waiting for the session to actually end.
  • Tweaked form styles to better fit phone-sized screens.
  • Updated the list of valid imgix parameters available in the Source-signing form.

Open-Source Libraries


New Min/Max Width and Height Parameters

  • Added four new parameters to the imgix API: min-w, max-w, min-h, and max-h. They are designed for working with scrolling feeds, so that very tall or very wide images don’t break the user experience. Check out the documentation (opens in a new tab) for more details.




Open Source


New Features


  • Fixed a small bug that caused the nav bar to overlap the main content in some cases
  • Improved authentication system to require fewer API calls on sign-in
  • Disabled the render_cache_ttl field in the source form. See this post (opens in a new tab) for more information.
  • Updated that dusty old "settings" icon. Less wrenchy, more coggy.

Open-Source Libraries

  • Upgraded imgix-swift to Swift 3 (opens in a new tab). This will not be merged to master and released until Xcode 8 is fully released, but is available for any folks currently working on updating their projects to Swift 3. We will release this branch as imgix-swift version 1.0.0 once Xcode 8 is publicly available.


Open Source


Expanded Color Palette Extraction


New imgix-swift Library

Update to SVG Pass-through

  • We've modified our SVG pass-through to require proper encoding per the W3C spec (opens in a new tab). SVG files that don't conform to the spec will returned as Content-Type:text/plain.


imgix.js 3.0

  • Launched a major update to imgix.js, our most popular library. It offers better stability, performance, and standards compliance, while making responsive design easier to implement. Check it out on Github (opens in a new tab).


  • Renamed the "Availability" graphs as "Delivery Success", to better reflect the actual metric being displayed.
  • Tweaked the margins to be marginally less marginal at larger screen sizes.

Velocity Conference



  • Added a new support view (opens in a new tab) with a form to write directly to our support team, and links to important sections of our documentation (opens in a new tab).
  • Added a proper error message when trying to request a password reset link for an email address that doesn't exist in our system.
  • Fixed a bug that prevented a useful error message from showing when trying to set a password using an expired link, instead showing a confusing generic message.
  • Fixed a bug in the source-signing view that prevented URLs with non-API parameters (including our own ixlib parameter) from being used.
  • Fixed another bug in the source-signing view that was showing an error message when using relative URLs for parameters such as mark and blend.
  • Made a number of minor style improvements to form fields nested inside of info-table layouts, such as in the account view (opens in a new tab).








Library Updates


  • We no longer show the billing-info update notification for accounts that use alternate payment methods.
  • Fixed a bug where tooltips on the source detail view were floating over the nav bar.



  • Redesigned the navigation section to leave more room for your forms and content.
  • Updated the users list section of the Account view (opens in a new tab) with a clearer design.
  • Added the ability to reset any user's API key directly from this section.


2016 imgix Responsive Image Survey

Building Dynamic Social Images Post


  • Updated account and user details sections of the Account view (opens in a new tab) with better layouts and more usable forms.
  • Fixed permissions for read-only users, allowing them to visit the account view and edit their own user details.
  • Fixed a bug in Safari where the second field in a two-part form field wasn't accessible by click.
  • Fixed a bug in Safari that was preventing our handsome logo from appearing at the top of the sign-in and sign-up views. Why didn't anyone tell me about this sooner?


Kickstarter Case Study

Motif is Now Open Source

Built with imgix

  • All of our demonstration tools are now together on the "Built with imgix (opens in a new tab)" page. In addition to serving faster images, you can also use imgix as an advanced compositing engine to build completely new experiences, of which these are fine examples.

This Week in Client Libraries



  • Moved invoices, billing information, and plan details to the new consolidated billing view (opens in a new tab).
  • Fixed a bug that prevented "billing-only" users from adding or updating credit card information.
  • Renamed a bunch of routes throughout the app for better organization. No need to update your bookmarks, though: all old routes should be correctly aliased.
  • Improved the general behavior of errors on many forms, and the specific behavior of displaying email "typo" suggestions in the sign-up form.

Blog Post: Optimizing Quality and Speed for High-DPR Images



  • Added spiffy new "Edit in Sandbox" buttons to image examples.
  • Documented the ellipsis input for the txtclip parameter, which inserts an ellipsis (…) where specified in a truncated text string.


  • Updated news module on home view: better design, fewer API requests.
  • Fixed a number of minor bugs in the Source creation form.


Changelog image



  • Rebuilt the sign-up form to be a bit more user-friendly and include better error handling.
  • Rebuilt our password-reset flow to be easier to use.


Shopify Integration Guide

Motif—Social Media Image Generator

New Image URL Parameters

Base64 Blog Post

Sandbox Update


Revamped Documentation

New Tutorial

Dashboard Fixes

  • Fixed a bug that was preventing billing-only users from logging in
  • Fixed a bug that was breaking the auto-save feature on some form fields



CDN Map Added

Codepens Updated

  • We have a number of Codepen pens (opens in a new tab) and a growing library of examples and creative uses cases for imgix.
  • We have collected the popular Luminous and Drift library examples into a collection (opens in a new tab) to demonstrate image zoom, X-ray and lightbox implementations popular with e-commerce sites.


Library and Tool Updates

imgix-python 1.0.0 (opens in a new tab)

  • Change UrlBuilder#create_url to accept dict instead of kwargs. This fixes an issue with reserved words that are also imgix params potentially causing errors.

Luminous 0.2.3 (opens in a new tab)

  • Added caption support.
  • Added closeOnScroll option.
  • Improved image positioning.
  • Fixed package.json main should now point to dist file usable by more JS build setups.

Drift 0.1.5 (opens in a new tab)

  • Fixed package.json main should now point to dist file usable by more JS build setups.
  • Fixed HAS_ANIMATION bug when loaded in head
  • Fixed a syntax error in bower.json


New Front-End Libraries

Typesetting Endpoint

Documentation Updates

  • Improved examples for the bc, bs, bx, and by parameters


Fingerprinting Guide

  • Released a guide discussing how to fingerprint image assets to improve page speed by better managing cache keys and eviction. Read the guide in the documentation.

Documentation Updates




Documentation Updates

Client Library Updates

Office Updates



Our First Customer Meetup

  • Thanks to everyone who joined us at the Meetup this week—it was great to talk to you all face-to-face. Look for more in-person events in the future.




Unsplash Case Study

November Meetup

Client Library Updates


Client Hints

Documentation Updates

Library Updates


Eventbrite Case Study

imgix.js 1.2.0

  • Updated imgix.URL.getColors() method to use simple AJAX instead of CSS-injection. As a result of this, colors are being returned from lightest to darkest, rather than from darkest to lightest as they were previously. This change was made to bring the behavior of this method in line with the palette=json image API, which it now uses.
  • Removed several unnecessary polyfills, shaving 4KB off of the minified file size.

Documentation Updates



Service Bug Fixes and Enhancements

  • Fixed a bug where the bg and mask parameters would interact. bg dictates the background for the main image, while maskbg should be used to set the background for a mask.
  • Fixed a bug where rotated images would improperly rotate an additional 180 degress when using the rot parameter.
  • Improved border path scaling.

Dashboard Bug Fixes and Enhancements

  • Fixed a bug that was preventing read-only users from logging in.

imgix.js 1.1.4

  • Fixed a bug in imgix.buildUrl() that was causing port numbers to be ignored.
  • Fixed a bug where imgix.fluid() would ignore the crossorigin attribute on its targets.
  • Broke core.js and tests up into separate components.

Documentation Updates

  • Corrected discrepancies between trimcol and trimcolor in the docs. Note: trimcolor is the correct way to specify a trim color.
  • Added a note about using Dropbox as an origin for an imgix Source. Dropbox has made changes recently that prevents files from being permanently publicly accessible. For easy file hosting, we instead recommend using Amazon S3 (opens in a new tab).
  • Added a link for contacting support easily to the footer of each page.


Doc Updates


Enjoying imgix? Leave a review on our StackShare page! (opens in a new tab)


New Framework Libraries






StackShare Guest Post

Sandbox Updates

  • Added a debounce to all input changes, which cuts down on the number of requests Sandbox (opens in a new tab) makes leading to a snappier experience.

Documentation Updates

Enjoying imgix? Leave a review on our StackShare page! (opens in a new tab)


srcset Blog Post

dpi Parameter

markfit Documentation

Enjoying imgix? Leave a review on our StackShare page! (opens in a new tab)


Blend Artifacting


Web App

  • Improved invoice display to be clearer and account for all different pricing schemes.
  • Tweaked news item display to only display items less than two weeks old.


hue Parameter


8-bit and 32-bit PNGs

Typeface Search


Improved Analytics



Face Detection Crop




  • Created a new reference document for creating imgix URL libraries in new languages. This can help make sure that your new imgix library covers all of the corner cases. Available on GitHub: imgix/imgix-blueprint (opens in a new tab).









  • Removed all code pertaining to signing imgix URLs with your API token. We decided that this code isn’t well-suited for client-side code like imgix.js. If you need to use signed URLs, we suggest using one of our client libraries (opens in a new tab) instead.
    • Added a throttle parameter to imgix.fluid(). This parameter determines how often lazy-loaded images poll the viewport to determine whether they should load their source or not. This was previously defined by the debounce parameter, which also handles polling for window resize events. The default value for throttle is 200ms.
    • Fixed a bug (opens in a new tab) in our lazyLoad code that was preventing images clipped by the top or left sides of the browser viewport from rendering properly.
    • Fixed a bug (opens in a new tab) that could sometimes cause imgix.fluid() to not behave properly if the source image was already in the browser’s cache. Thanks to Josh French for catching the bug.
    • Released version 1.1.0 (opens in a new tab).



  • Fixed two issues (#27 (opens in a new tab) and #28 (opens in a new tab)) that manifested when an image was set to display: none;. The bug caused images to be requested at extremely large heights, leading to a sluggish browser experience.
  • Released version 1.0.25.

JSON Output Format

Web App

  • Added better validation to the default_params in the source view, to prevent illegal default parameters from being set. A common default parameter that we’re unfortunately not able to support at this time is auto=format.



Image trimming parameters


  • Merged a pull request from joshfrench (opens in a new tab) that fixes an issue with signed URLs. Thanks, Josh!
    • Fixed an issue with the library not correctly working with and encoding fully qualified URLs for Sources with the Web Proxy type. See pull request (opens in a new tab).
    • Bumped the Ruby library version to 0.3.3. Update your projects.


  • Fixed a bug in Safari that caused lazy-loaded images to repaint relentlessly.


  • Fixed an issue with the txtclr documentation. Previously, the default txtclr value was listed as fff, which was incorrect—the actual default value is 000.


Image API

imgix.js v1.0.22


  • Posted a behind-the-scenes article about racking Mac Pros in our data center. If you like server racks and hate deep focus, take a look (opens in a new tab).
  • Started this changelog.