Getting StartedSetupQuick Start Guide

Quick Start Guide

Getting set up with imgix is easy—just tell us where your assets live, choose an imgix subdomain, and you can start serving assets through our Rendering API in minutes.

The quick-start instructions are below. For Source specific instructions, head to the Creating Sources guide. If you have a more complex integration, advanced details such as cache TTL, default parameters and custom domains can all be adjusted post-Source-deployment in the Advanced Source Settings. For recommendations about setting up your assets before integrating with imgix, see the Setting Up Asset Storage guide.

For information about analytics and adding users or payment methods, see Account Setup & Analytics.

Create an imgix Account

First, sign up for your own imgix Account. Start for free.

Create an imgix Account

10 Minutes to Serving with imgix

Once you’ve signed up or signed in to your imgix account, you’ll land on the dashboard, which is the hub for all operations and stats for your account. Here’s the simplified process for creating your first Source and serving your first assets.

Create a Source

Before you can begin optimizing your images and videos with imgix, you will need to create a Source. Sources grant imgix a direct connection to your media. To get started, tell us where you store your assets. Screenshot-Message asking to select your Source

Configure Source Details

In Step #2, you will be prompted to fill in your storage details (this set of options will vary based on your specified storage type). Screenshot-Source credentials configuration

Define Your Subdomain

In Step #3, you will be prompted to name your imgix.net subdomain (the root of the URL you’ll use to serve assets). Screenshot-Source subdomain configuration Note: The subdomain name you choose is unique to your Source and can’t be re-used. If you’re setting up a Source with a lot of customization (particularly a Custom Domain), choose the name you plan to use going forward.

Deploy Your Source

Select the Deploy Source button to save your changes and queue your Source for deployment. Once successfully deployed, your images and videos will become connected to imgix and the subdomain will be active. Screenshot-Source deployment screen

Serve your first Asset

Try out a test asset using the subdomain you created in Step #3. Just type https://your_domain.imgix.net/path-to-your-asset into a browser window and your asset should appear. SCreenshot-Served Asset

Now that you know the connection is working, you can start applying our API parameters to optimize your assets. Here are some good next steps:

  • Rendering API Documentation: Describes all of the available Rendering API parameters, with examples.
  • Serving assets guide: This guide will show you the recommended operations that most of our customers use to optimize their assets.
  • Advanced Settings: This doc will show you all the various settings that can be configured for any of your Sources.
  • Developer Tools: Once you’ve figured out the parameters you want to use, you can use our client libraries to build out image helpers in most modern languages and frameworks.