V6 is the old, legacy version of Cloudimage. Its features are limited, and its functionalities are no longer supported or developed. V6 has its own distinctive syntax:
https://token.cloudimg.io/cloudimage-filters-and-operators/original_path/image.jpg
V7 is the most recent version of Cloudimage that is currently supported and developed. It has a ton of fresh new features, filters, and operators. It uses the following syntax:
https://token.cloudimg.io/original_path/image.jpg?filters&operators
As you can see:
- The same Cloudimage token can be used in image URLs written in V6 and V7 format. What makes the difference is the image URL syntax.
- In V6 format, the Cloudimage operators and filters are put right after token.cloudimg.io
- In V7 format, the Cloudimage operators and filters are put at the end of the URL as a query string.
The syntax for some operators in V6 differs from that of the corresponding functionality in V7. The most frequently used V6 Cloudimage parameters and the corresponding V7 features are listed below.
- /cdn/ - Delivers the image via CDN without any filter or resizing. This functionality is enabled by default in Cloudmage V7; thus, there is no need to write it manually.
- /cdno/ - Delivers the image via CDN with filter. This feature is also enabled by default in V7; thus, there is no need to append it to the V7 image URL.
- /bound/ - Resizes to a given /width x height/ box and keeps proportions. Similar to /fit/ but without padding. Delivers the resulting image via CDN. In Cloudimage V7, this operator also exists, and its documentation can be found here.
V6 URL:
https://token.cloudimg.io/bound/200x200/n/sample.li/birds.jpg
Same image URL converted to V7 format:
https://token.cloudimg.io/v7/sample.li/birds.jpg?w=200&h=200&func=bound - /width/ -Resizes the image to a given width (in pixels), keeps proportions, and delivers the resulting image via CDN. If you want to block the resize to a bigger size than the original, you can combine width with the foil1 filter.
V6 URL:
https://token.cloudimg.io/width/200/n/sample.li/birds.jpg
Same image URL converted to V7 format:
https://token.cloudimg.io/v7/sample.li/birds.jpg?width=200
or
https://token.cloudimg.io/v7/sample.li/birds.jpg?w=200 - /height/- Resizes the image to a given height (in pixels), keeps proportions, and delivers the resulting image via CDN. Same as for width, you can combine height with the foil1 filter to prevent Cloudimage from resizing to a size bigger than the original image.
V6 URL:
https://token.cloudimg.io/height/200/n/sample.li/birds.jpg
Same image URL converted to V7 format:
https://token.cloudimg.io/v7/sample.li/birds.jpg?height=200
or
https://token.cloudimg.io/v7/sample.li/birds.jpg?h=200 - /tjpg/- Forces the compression to JPG. In Cloudimage V7, the corresponding functionality is force_format=
V6 URL:
https://token.cloudimg.io/tjpg/sample.li/birds.jpg
Same image URL converted to V7 format:
https://token.cloudimg.io/v7/sample.li/birds.jpg?force_format=jpg - /qXX/ - JPG quality index. The smaller the value of X, the more your image will be compressed. In Cloudimage V7, it is replaced by q=X
V6 URL:
https://token.cloudimg.io/q80/sample.li/birds.jpg
Same image URL converted to V7 format:
https://token.cloudimg.io/v7/sample.li/birds.jpg?q=80 - /foil1/ - Prevents the image from getting resized to a bigger size than the original. In Cloudimage V7, it is replaced by org_if_sml=1
V6 URL:
https://token.cloudimg.io/width/5000/foil1/sample.li/tesla_600_400.jpg
Same image URL converted to V7 format:
https://token.cloudimg.io/v7/sample.li/tesla_600_400.jpg?width=5000&org_if_sml=1
If your Cloudimage URLs are still in V6 format, we strongly advise you to upgrade to Cloudimage V7.
If you have any questions or issues, please feel free to contact our Software Engineer and mention the following details:
- Token
- Short description of the issue (including URLs, screenshot, short video if available)
- Steps to reproduce the issue.
Comments
Please sign in to leave a comment.