A Web Folder Source connects to your existing folder of assets that are on a publicly addressable website, usually your website’s existing asset folder.

Setting Up Your Web Folder Source

  1. Go to the Sources page in the imgix dashboard and click the New Source button.

  2. Select Web Folder from the How do you store your media? radio options. Screenshot-Web folder source setup

  3. Specify the Base URL for your Web Folder Source - you must use a valid web URL that we can fetch from. Screenshot-Web folder source setup

    Note: To improve deliverability, you should use a path that will not redirect. For example, if your domain will redirect traffic from http to https, you should use https in your Base URL configuration.

  4. Name the Subdomain you'd like to use as the base URL for your assets. Screenshot-Web folder source setup

    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.

    • If you are editing an existing Source and the Video API is enabled, the imgix Video Subdomain field will be visible. This field automatically inherits the value from your imgix Image Subdomain and cannot be modified without changing the Image Subdomain.

  5. Click the Deploy Source button on Step #3 to queue your Source for deployment. Screenshot-Web folder source setup

Accepted Base URLs

Your Base URL must be accessible by imgix in order for us to fetch assets from your Web Folder Origin. If your Web Folder URL blocks imgix from accessing your assets or requires a login to access assets, we will fail to fetch your assets from your Origin.

If your Web Folder Origin has a firewall, please add the imgix user-agent to your allowlist.

Additionally, Web folder URLs must be valid and follow the RFC spec. We use these rules for validating Base URLs:

  • Each level (split by a dot) may contain up to 63 characters.
  • The full domain name may have up to 127 levels.
  • The full domain name may not exceed the length of 253 characters in its textual representation.
  • Each label can consist of letters, digits and hyphens.
  • Labels cannot start or end with a hyphen.
  • The top-level domain (extension) cannot be all-numeric

Advanced Settings

See the Advanced Source Settings for information about setting up custom domains, defaults, and cache TTL options.

S3/GCS/Azure preferred
Whenever possible, it is recommended to use a natively-supported Source such as an S3 or GCS Source type for deliverability.


Next: Serving Assets