Cloudinary Blog

Image opacity manipulation and dynamic watermark generation

Modifying an image opacity so the image is semi-transparent is a common requirement when implementing modern graphics design. Reducing image opacity allows background images to feel less dominant. Reducing opacity also allows layering of multiple images one on top of the other, an important step when adding watermarks, badges and textual overlays to images.
Modern web browsers support opacity manipulation via CSS directives. This however does not solve the problem completely. Watermarks need to be embedded as part of the original image and can't be added on the client's side. In addition, manipulating the opacity of the image itself allows for a consistent view across all your service's mediums - website, mobile application, emails (notifications) and PDFs (reports). Emails in particular do not support many of the modern CSS directives.
In this blog post we wanted to show how you can use Cloudinary's cloud-based image transformations to easily manipulate the opacity of images and how to use this technique to add watermarks to images.
page load speed

Dynamically changing Image Opacity

Let's look at the following image the was uploaded to the cloud using the 'mountain' public ID.
You might want to use an image like the one above as a background image for a section of your web or mobile application. Simply set the 'opacity' parameter (or 'o' for URLs) to the desired percentage and Cloudinary will automatically modify the opacity of the image on-the-fly. As always, the resulting image is stored persistently in the cloud  and delivered optimized and cached to your worldwide users through a fast CDN.
The following example reduced the mountain image opacity to 20%. Now you can safely place text and other graphical elements above this image.
Below are examples of generating a transformation URL with modified opacity using our client libraries for Rails, PHP, Django and Node.js
Copy to clipboard
<%= cl_image_tag("mountain.jpg", :opacity => 20) %>
Copy to clipboard
<?php echo cl_image_tag("mountain.jpg", array("opacity" => 20)) ?>
Copy to clipboard
import cloudinary
img = cloudinary.CloudinaryImage("mountain.jpg")
Copy to clipboard
cloudinary.image("mountain.jpg", { opacity: 20 });

Grayed-out Logos

Another common graphic design practice is to display a list of logos of customers and partners in your web site. Instead of the original, colorful logos, many web designers prefer to display semi-transparent grayed versions of these logos so they don't take attention from the website's messaging. 
With Cloudinary you can dynamically gray out images, and easily modify them in case your graphic designer has a change of heart.
In the following example, we've uploaded multiple logos to Cloudinary. We've went further and used Cloudinary's sprite-generation capabilities to merge these logos into a single sprite image for better performance:
By simply setting the 'effect' parameter (or 'e' for URLs) to 'grayscale' and setting the 'opacity' parameter ('o' for URLs), Cloudinary generates a semi-transparent gray-scale version of the logos for embedding in your website:


Generating Watermarks

In a previous blog post, we've shown how you can easily add overlays to images. Such overlays could be used to add watermarks to images using a previously uploaded semi-transparent PNG image of such watermark. With the new opacity manipulation transformation, you can file upload your non-transparent watermark image and manipulate its opacity dynamically to make it semi-transparent, ready for adding as a watermark overlay.
The following example adds the previously uploaded image 'cloudinary_icon' as a 200 pixels wide overlay above the mountain image:
Now, by setting opacity to 40%, the overlay becomes semi transparent:
You can also apply an effect or filter on the overlay. In the following example we've increased the brightness of the overlay to make it white and reduced opacity to 30%:
The code samples below detail how to build the same URL in Ruby, PHP, Django and Node.js:
Copy to clipboard
<%= cl_image_tag("mountain.jpg", :opacity => 30, :effect => "brightness:20", 
                  :width => 200, :overlay => "cloudinary_icon") %>
Copy to clipboard
<?php echo cl_image_tag("mountain.jpg", array("opacity" => 30, 
  "effect" => "brightness:20", "width" => 200, "overlay" => "cloudinary_icon")) ?>
Copy to clipboard
import cloudinary
img = cloudinary.CloudinaryImage("mountain.jpg")
img.image(opacity=30, effect="brightness:20", width=200, overlay="cloudinary_icon")
Copy to clipboard
  { opacity: 30, effect: "brightness:20", width: 200, overlay: "cloudinary_icon" });


Dynamic opacity manipulation and watermark generation are some of the newest Cloudinary capabilities in your image manipulation tool-belt. These capabilities further simplify your web and mobile applications tedious image management tasks. 
With a simple URL (or one line of code) you can generate images that match your ever evolving graphic requirements and deliver them quickly to your users. You don't have to deal with complex non-standard CSS directives and you don't have to use over-qualified graphical software like Photoshop to generate images in your desired color balance and opacity.
Please share your thoughts and let us know how we can further improve Cloudinary's growing feature set.

Recent Blog Posts

Laravel File Upload to a Local Server Or to the Cloud

Currently, Laravel is the most renowned PHP framework, boasting of a large developer community; several open-source packages, such as Cashier, Sanctum, Scout, and Telescope; and a host of paid platforms, e.g., Laravel Forge, Envoyer, and Vapor. Laravel Forge & Envoyer ably supports deployment and use of Laravel production-based apps.

Read more Automates Generation of Captivating Product Images on Cloudinary

At, we digitally restore historic maps and sell their art prints on multiple platforms, such as Amazon, Etsy, eBay, and Houzz. As our operations ramped up years ago, it took an inordinately long time to generate custom images for our products. Plus, since we sell art, it behooves us to produce multiple high-quality images for each print, which was another time-consuming task.

Read more Takes a Vacation From Media-Management Headaches With Cloudinary

As a 20-year online leader in travel and leisure retail, Europe-based public company along with its 1,200 employees are committed to enriching the lives of vacationers through comprehensive and enticing products and services. Beyond flight deals and tours, it's the images and videos, whether of that luxury villa in Greece, romantic Parisian street, or exotic stroll through the Marrakech markets, that attract audiences and boost bookings.

Read more