Cloudimage - Documentation

Manual implementation

If your Web application does not use a CMS (Wordpress, Drupal, ...), e-commerce platform (Prestashop, Magento, ...) or development framework (React, Angular, Django, ...) then you need to adapt your image URLs in your HTML <img> tags.

For example, if your origin image is available at http://sample.li/flat.jpg and referenced in your code as:

<img src="http://sample.li/flat.jpg" />

Then you need to adapt it to be:

<img src="https://token.cloudimg.io/v7/http://sample.li/flat.jpg?operations&filters" />

Where:

  • token: your Cloudimage token you obtain after registering for a Cloudimage account
  • operations: the resizing operation(s) as listed under Operations
  • filters: the filter transformation(s) as listed under Filters

If you have implemented responsive design with the HTML <picture> and <srcset> elements, then you need to change every <srcset>:

<picture>
  <source media="(min-width: 650px)" srcset="/sample.li/flat.jpg">
  <source media="(min-width: 465px)" srcset="/sample.li/flat.jpg">
  <img src="img_orange_flowers.jpg" alt="Flowers" style="width:auto;">
</picture>

Becomes:

<picture>
  <source media="(min-width: 650px)" srcset="token.cloudimg.io/v7/sample.li/flat.jpg?operations1&filters">
  <source media="(min-width: 465px)" srcset="token.cloudimg.io/v7/sample.li/flat.jpg?operations2&filters">
  <img src="img_orange_flowers.jpg" alt="Flowers" style="width:auto;">
</picture>

You need to define the image size with operations1 and operations2 to deliver the lightest possible image. If you want Cloudimage to do the job for you and define the optimal size based on your container width, then look at our JS lib, React and Angular plugins.

Url-encoding resource URL

ci_url_encoded=1

If a resource is versioned or dynamically generated using query strings, you can url-encode the URL of the resource and add the ci_url_encoded=1 to the Cloudimage URL.

For example, in the origin below, the w=22 query string is part of the static resource:

http://sample.li/gen.php?w=22

To create a Cloudimage URL from is, the resource is url-encoded and the width operation can be used correctly:

http://doc.cloudimg.io/v7/http%3A%2F%2Fsample.li%2Fgen.php%3Fw%3D22?w=400&ci_url_encoded=1