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

NEW: Japanese Translation Available
We've created a Japanese version of our Quick Start Guide to download. Click here to get yours!

日本語翻訳クイックスタートガイドはここからクリックしてゲット!

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.

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.

  1. 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

  2. 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

  3. 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.

  4. 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

  5. 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.

Next: Setting Up Asset Storage