Imagizer Documentation

Appearance

Imagizer Cloud ​

Let us handle the infrastructure. Imagizer Cloud is the fastest way to get started. Pay only for what you use and go production-ready in minutes without changing your workflow.

Create an account if you don't have one yet.

Getting Started ​

Create Source ​

  • If you chose a Web Folder, enter the Base URL now. The base URL is typically your website's domain.
  • Optionally, enable global image optimization to apply settings to all images. Choose from three presets (Low, Medium, High) or enter custom parameters. See the API Reference for all available parameters.
  • Click the Create button.
  • Take note of the Imagizer endpoint.

Congratulations! Your Imagizer Cloud source is now running. You can test the source by navigating to the endpoint in a browser.

TIP

Visit the Usage guide for information on how to use Imagizer.

Basic Configuration ​

Image Storage ​

Web Folder ​

The base URL points to where your images are stored. Any publicly accessible web URL works, including AWS S3 endpoints.

Examples

Amazon S3 ​

The Amazon S3 storage type supports private Amazon S3 buckets where your images are stored.

Toggle the uploads option to enable image uploads through Imagizer. See the uploads guide for more information.

TIP

You must create an IAM User with a policy containing the s3:getObject permission and provide the AWS Key and AWS Secret credentials for private buckets.

TIP

Uploads require the s3:putObject permission.

Imagizer Storage ​

Imagizer offers free built-in storage backed by Amazon S3 for high reliability and data protection. Upload images directly to Imagizer.

Default Parameters ​

Apply global parameters to every request or just mobile requests. This lets you add compression and formatting without modifying image URLs.

Use any parameter from the API reference. Imagizer also provides optimized presets that compress, resize, and format images for each device type.

TIP

Default Parameters may be overridden by client-supplied URL parameters.

Advanced Configuration ​

Custom Domain ​

Use your own domain by adding a CNAME record pointing to your Imagizer endpoint.

Image Cache ​

Imagizer caches all original and processed images. You can disable caching if needed, though this is not recommended.

Cache Control Headers ​

Imagizer respects Cache-Control headers from origin images. Browser Cache TTL and Server Cache TTL settings only apply when origin images lack Cache-Control headers or when override is enabled.

Ignore Formats ​

Specify a comma-separated list of image formats to skip processing. These images pass through untouched.

URL Rewrites ​

Modify request URLs before processing with search-and-replace rules. Change paths or query parameters on incoming requests. Both string and regex (PCRE) patterns are supported, and you can add multiple rewrite rules.

Expert Configuration ​

Imagizer JSON Config ​

Enter a full JSON configuration object for advanced settings. See the Config reference for all available options.

Miscellaneous ​

Watermarks ​

Apply watermarks to all images using Default Parameters.

Example ​

Add watermark parameters to the All requests field. See the Watermark API reference for configuration options.

All the images requested through your source will now have a watermark embedded.

API ​

Authorization ​

Get an authorization token from cloud.imagizer.com/tokens and include it in the Authorization header with each API request.

http
Authorization: Bearer {auth_token}

Purge Files ​

TIP

It may take a few minutes for purging to complete.

Purge All ​

Purge all images from the given source.

http
DELETE https://cloud.imagizer.com/api/v1/sources/{SOURCE_NAME_OR_ID}/cache HTTP/1.1

Authorization: Bearer {AUTH_TOKEN}
Accept: application/json
Example ​
bash
curl -X DELETE \
-H "Accept: application/json" \
-H "Authorization: Bearer {AUTH_TOKEN}" \
https://cloud.imagizer.com/api/v1/sources/{SOURCE_NAME_OR_ID}/cache

Purge Specific File(s) ​

Purge specific images from the given source.

Pass an array of image paths to the files property.

http
DELETE https://cloud.imagizer.com/api/v1/sources/{SOURCE_NAME_OR_ID}/cache HTTP/1.1

Authorization: Bearer {AUTH_TOKEN}
Accept: application/json
Content-Type: application/json

{"files":["/images/myimage1.jpg","/images/myimage2.jpg","/images/myimage3.jpg"]}
Example ​
bash
curl -X DELETE \
-H "Accept: application/json" \
-H "Content-Type: application/json" \
-H "Authorization: Bearer {AUTH_TOKEN}" \
-d '{"files":["/images/myimage1.jpg","/images/myimage2.jpg","/images/myimage3.jpg"]}' \
https://cloud.imagizer.com/api/v1/sources/{SOURCE_NAME_OR_ID}/cache

© Copyright 2025 Nventify, Inc.