Documentation

Getting Started

imgix is designed to make delivering dynamic images for your website or app easy and performant. The guides in this section will get you up and running with imgix quickly and easily.

Quick Start

Go through the Creating Sources and Serving Images guides, and then dive into the API documentation and tutorials to start using the Image URL API with your image catalog. For more detail about setting up and using your account, keep reading!

Setting Up Your Account

When you sign up, you’ll start at the Dashboard, which is where your basic analytics, account activity, and billing information will appear once you’ve connected your images to imgix. From the left nav, you can dive deeper into these categories anytime.

Adding Additional Users

If your company requires different levels of access based on roles (e.g. engineering and accounts payable), you can set that up for as many people as necessary. imgix supports four role types:

  • Owner: Has all permissions, including adding other users to the account.
  • User: Has all permissions except the ability to add other users to the account.
  • Billing Only: Can’t view Sources and Source Tools, and cannot add other users to the account.
  • Read Only: Can only see the Dashboard and Analytics, and cannot add other users to the account.

To add a user:

  1. Go to the Users section of your account.

  2. Under “Add New User”, fill in a full name, email address and role, and click Create User.

    Screenshot-add user form

Once you submit the form, the user will receive an email with a link to the page where they can set their login information. The page will expire after 24 hours.

Adding a Credit Card

All new imgix accounts start with $10 credit toward the first month, so you can try out the service risk-free. After the credit is used up, you can enter a credit card to continue using the service (if your company isn’t already being invoiced). Here’s how to add a credit card to your account.

  1. Go to Billing and under “Payment Details”, click the Update button. Screenshot-Add Credit Card
  2. Enter the credit card information and click the Save button.

If you have a “Billing Only” user, you may want to have them do this. To set up a contract and invoicing for your company, please contact Sales.

Understanding Analytics

The Analytics section offers usage statistics for your account and for imgix’s service health. You can use these to gauge your site or app’s usage over each month. For definitions of the terms, click the (?) icons in each section or check out the Glossary.

Here are some basic concepts to understand in relation to imgix’s analytics and pricing. Some older pricing plans may differ from the descriptions below.

Master Images vs. Renders

Master images are your original images, stored on your servers or another web host such as Amazon S3. Renders (or derivative images) are the images we deliver to your users after our API parameters are applied. Each unique variation of an image counts as a render, so you should expect to see more renders than masters, given that you may be delivering the same image with different parameters depending on your user’s context.

Under our current pricing, we only charge for the master images that are requested, and don’t charge for creating derivatives. The counter for master images resets at the beginning of each month, so you should expect to see a spike then as masters are requested for the first time and counted.

Total Bandwidth

Though we don’t charge to create derivative images, we do charge for the bandwidth necessary to deliver them to your end users (Total Bandwidth). This includes the bandwidth to request the derivative image from imgix’s rendering engine into the CDN (Render Bandwidth) and cache it, and then deliver the derivative from the CDN to the user (CDN Bandwidth). Fetch Bandwidth is tracked on this page but not charged under our current pricing.


Other Resources

  • Glossary: Terminology specific to imgix and content delivery
  • Status Codes: List of status codes returned when there’s an error processing an image
  • Guides: Industry best practices related to images (e.g. SEO, caching)
  • Tutorials: In-depth walkthroughs of how to implement imgix for specific use cases

Next: Creating Sources