The Image Manager is a new way for you to search, visualize, browse, and organize any images in your cloud storage bucket. Your Image Manager can be configured to detect all of the images stored in your bucket, or just the images that your users are accessing via imgix. Unlike cloud storage providers, imgix offers a visual interface with thumbnails of all of your images so you can quickly see the contents.

Accessing the Image Manager

Navigate to the Image Manager by clicking the “Images” link in the top navigation bar of the Dashboard. If you don’t have an “Images” link or if you get an error message, you may not have the Image Manager enabled for your account. Contact us if you would like to enable this premium feature for your account.

Note: The Image Manager is a premium feature and may not be enabled for all accounts. Contact Support or your Account Manager to find out more.

Browse

The homepage of the Image Manager will show the List View, which you can use to browse all of your images in a particular Source. You can switch between Sources by selecting from the Source dropdown in the upper left corner (you will not see a dropdown option if your Image Manager setup has only one Source with images).

Screenshot of Source picker

By default, images are sorted by Date Created, with the most recent images first. The other supported sorts are Date Updated and File Size. All sorts can be either ascending or descending.

Screenshot of Sort picker

Image Details

Clicking on an image thumbnail in the List View will load that image’s details in the Info Panel on the right.

Screenshot of info panel

The Info Panel displays metadata, machine learning–generated tags, user-defined categories, user-defined custom fields, content alerts, and color data. Each section can be toggled open or closed and the Image Manager will remember the closed/open state per device/browser.

Metadata

This section displays image metadata, including:

  • Filename
  • Clickable imgix URL (e.g. https://assets.imgix.net/examples/bridge.jpg)
  • Content Type
  • File Size
  • Dimensions
  • DPI
  • Faces (if face detection is enabled for your account)

Screenshot of metadata

Image Tags Image tags are generated by machine learning–powered analysis. Tags are used to describe the content or subject matter of the image. Tags are displayed in order of their confidence score, which you can see if you hover over a specific tag.

Screenshot of tags

Clicking on a tag will execute a search for other images in that Source with the same tag.

If you would like to remove a tag from an image, click the “Edit” button, click the “×” next to any tag that should be removed, then click the “Save” button. Removed tags will still appear but will be greyed out and the confidence level will be set to 0%.

Image tag generation is a premium feature and is not available for all accounts. Contact us if you would like to enable this premium feature for your account.

Categories

Categories are defined by users and can be used to organize your images. To add a category, click the “Add” button and then either choose an existing category or click “Add new category” and type a new category. Clicking on a category will execute a search for other images in that Source with the same category.

Screenshot of categories

Categories can be removed or edited via Image Manager Settings (link to IM settings section).

Custom Fields

Custom fields are key-value pairs defined by users that can be used to associate information with your images. A common use case is to add a user or product ID, where the key might be “User ID” and the value would be “123”. To add a custom field, click “Add”, then either select from available keys or select “Add New Key”. Enter your key and value, then click “Save”.

Screenshot of custom fields

Custom field keys can be removed or edited via Image Manager Settings (link to IM settings section).

Content Alerts

Content alerts are generated by machine learning–powered image analysis and cover five categories: Adult, Violent, Medical, Racy, and Spoof. Each image will receive a score in each of the five categories, listed here from low to high probability: Doubtful, Unlikely, Possible, Likely, Probable. If the image scores Likely or higher in either the Adult or Violent categories, the icon in the content alerts header will change to reflect the severity of the content alert. (The image highlighted in the screenshot below is not actually classified as Possible Adult; it is only used as an illustration.)

Screenshot of content alerts

Content alerts are a premium feature not available for all accounts. Contact us if you would like to enable this premium feature for your account.

Color Data

The color data section will show the color profile, color model, and the image’s dominant colors. Clicking on a color will execute a search for other images that contain that color.

Screenshot of color data

Image Detail View

The image detail view shows the image at a larger size and at its original aspect ratio. Open the image detail view either by clicking on an already-selected image thumbnail in the list view or by double-clicking on an image thumbnail in the list view. Exit the image detail view by clicking the “x” in the upper left corner or by pressing Esc on your keyboard.

Screenshot of image detail view

The image detail view also has an option in the upper right corner to show or hide the image. Hiding an image will pixelate the image so that the original content is no longer discernible, and showing an image will restore the original image. Showing or hiding an image only has an effect within the Image Manager; it does not impact the actual rendering of the image outside of the Image Manager. Once an image is shown or hidden, it will remain that way inside the Image Manager, though that state will not be saved across browsers/devices or across users.

By default, any image that scores “Likely” or higher in the Adult or Violent category will be shown as hidden.

Screenshot of hidden image

Searching

Keyword Search

Typing in the search box near the top of the screen will execute a keyword search. This will search across multiple pre-determined fields, such as the image origin path, the name, description, tag, category, custom field, etc. Exact behavior is subject to change.

Screenshot of keyword search

Tag Search

Searching can be performed by tag. Navigate to an image and click on one of its tags to execute a search for other images with the same tag.

Screenshot of tag search

Category Search

Searching can be performed by category. Navigate to an image and click on one of its categories to execute a search for other images with the same category.

Color Search

Searching can be performed by color. Navigate to an image and click on one of its color swatches to execute a search for other images with a similar color.

Advanced Search

To perform more complex searches, click on “Advanced” in the right side of the search bar. Use Advanced Filters to search based on tags, categories, custom fields, colors, folder path, content alerts, faces, animations, file types, and whether the image has been edited by a user. Selecting multiple filters will execute a search for images that meet the criteria of all of the filters.

Screenshot of advanced filters

Image Manager Settings

The Image Manager Settings page allows users to edit their created categories and custom fields keys. Access this page by clicking on the link in the Account Settings page or by clicking on the gear icon in the upper right corner of the Image Manager.

Screenshot of settings icon

Editing a category or a custom field key will automatically update that category or custom field key for every image that is associated with that metadata. Deleting a category or custom field key will remove that metadata from every image with which it is currently associated. Note: Deleting a category or a custom field key is not reversible, so proceed with caution.

Uploading

The Image Manager allows you to upload directly to your cloud storage–backed Source (Azure, GCS, or S3). Uploading to Web Folder or Web Proxy Sources is not supported.

Before you begin uploading assets to a Source, you must complete the Upload Setup for each Source you wish to upload to.

Why Is Uploading Setup Required?

When you set up your Source for rendering, imgix only requires read and list permissions—the minimum permissions required to render images. Write permissions are required for uploading, and we recommend using separate credentials to ensure your rendering is not impacted.

Upload Setup

If your Source has not yet been configured for uploading, clicking the “Upload” button in the upper right corner of the Image Manager. Alternatively, dragging and dropping files into the List View will bring you to the Upload Setup view.

Screenshot of upload setup

We highly recommend generating new credentials just for use by imgix and that they be separate from your rendering credentials.

Azure

For an Azure Source, you will need to generate a new shared access signature (SAS) token. To generate your SAS string, use the Shared Access Signature Settings page for the storage account. Change the following settings:

  • Allowed Services: Select File or Blob, depending on the service type.
  • Allowed Resource Types: Select only Container and Object.
  • Allowed Permissions: Select Read, List, and Write.
  • Start and Expiry Date/Time: Change the end date to “2029-01-01” or choose a date at least one year in the future.

Finally, click Generate SAS and connection string. Below that is a text box labeled “SAS token”. The token begins with “?sv=”. The contents of this text box are your SAS token.

GCS

If you’re using a GCS Source, you can add the Storage Object Admin role from GCS’s role list. After you add the role to the user, you must generate the interoperability key by going to the Settings page in your console, then generating the key in the Interoperability tab.

S3

The "Amazon S3 Full Access" policy template for your IAM account is the easiest way to create new S3 credentials for uploading.

  1. Go to your AWS IAM Dashboard.
  2. Click Users on the left navigation.
  3. Click Add User or select an existing user.
  4. If adding a User, give them a User Name and enable Programmatic access. Select Next: Permissions.
  5. Click the Permissions tab and then the Add Permissions button.
  6. Select the Attach existing policies directly tab.
  7. You will be presented with a list of policy templates. Scroll down or search until you see “Amazon S3 Full Access” then click the Select button next to it.
  8. Click Next: Review and then Add Permissions.

Or, if you prefer to set specific permissions, grant the following:

  • ListBucket
  • GetBucketLocation
  • GetObject
  • PutObject

Uploading Images

Once your upload setup is complete, you can being uploading by clicking the “Upload” button in the upper right corner of the Image Manager or dragging and dropping files into the List View.

Screenshot of upload manager

Here you can specify an optional destination path for all of the images in the current upload. This is useful if you would like to upload your images into a specific subdirectory.

Note: The Image Manager will not overwrite anything already in your bucket. If you already have a file named bridge.jpg in your bucket and you try to upload another file named bridge.jpg to the same place in the bucket, the upload will fail.

After clicking “Upload” you will be taken to the Upload Manager view, which shows the progress of your uploads. Upon completion, click the “View” button to be taken back to the Image Manager to view your newly uploaded files.

Screenshot of uploaded images

Newly uploaded images are immediately available in the Image Manager and can be searched for and modified just like any other image.

Image Manager APIs

Nearly all of the functionality provided by the Image Manager in the Dashboard can also be accomplished via API. Read the documentation for the Image Manager API to find out more.