How to add a watermark with ImageMagick
With ImageMagick, place a logo using magick composite with -gravity and -geometry, or draw text with -annotate; mogrify handles many files. The -watermark option is a brightness and saturation operator, not a logo overlay. mogrify overwrites the originals unless you give it -path.
Published . Drafted with AI assistance and checked against the sources linked on this page. How we write our guides.
ImageMagick watermark image: place a logo with composite
ImageMagick's composite page says to use the composite program to overlap one image over another. Its example uses gravity to centre the overlay: magick composite -gravity center smile.gif rose: rose-over.png. The page does not state a version number, and it has no logo-watermark recipe, so what follows is built from the options it documents.
The same page shows -geometry +30+30 -composite for placing an overlay at an offset; that example is about blending two images, and we borrow only its option syntax. The options page names the gravity choices: NorthWest, North, NorthEast, West, Center, East, SouthWest, South, SouthEast. It adds that when -gravity comes before an option that takes an offset, the offset is usually applied to the point in the image that the gravity argument suggests.
Our own example, following those documented options (it is not an ImageMagick recipe): magick composite -gravity southeast -geometry +20+20 logo.png photo.jpg photo-marked.jpg. It sets the logo in the bottom right corner, 20 pixels in from the edges. If your logo has a see-through background, see our guide to a transparent PNG logo.
ImageMagick watermark opacity: -dissolve, and what -watermark is
For a semi-transparent logo, the options page documents -dissolve with the syntax -dissolve src_percent [x dst_percent]. It says the opacity of the composite image is multiplied by the given percent, then composited "over" the main image. The page also warns that dissolve percentages do not add, so with a plain overlay use one value. Our example, again built from the documented option: magick composite -dissolve 40 -gravity southeast -geometry +20+20 logo.png photo.jpg photo-marked.jpg. The value 40 is ours; for a starting range, see our watermark opacity guide.
ImageMagick also has an option named -watermark, with the syntax -watermark brightness x saturation. The options page describes it as watermarking an image using the given percentages of brightness and saturation: it takes a grayscale image (with alpha mask) and modifies the destination image's brightness according to the watermark image's grayscale value. That is a different job from placing a logo, so for a logo we use composite, as above.
ImageMagick watermark text: annotate, font, pointsize and fill
For text, the options page documents -annotate {+-}tx{+-}ty text. It says that without an offset the text lands at the upper left, and that adding a -gravity option in this case leads to nice results. The page points to -draw for more precise control.
Three more documented options set how the text looks: -font name, -pointsize value and -fill color. The page says -fill accepts a colour name, a hex colour, or a numerical RGB, RGBA, HSL, HSLA, CMYK or CMYKA specification, and to enclose the colour in quotation marks; its examples are -fill blue, -fill "#ddddff" and -fill "rgb(255,255,255)".
Our example, assembled from those options: magick photo.jpg -gravity southeast -pointsize 36 -fill white -annotate +20+20 "Your Name" photo-marked.jpg. Add -font with a font name installed on your machine if you want a particular typeface.
ImageMagick add watermark to many images with mogrify
The mogrify page shows examples that run on every file matching a pattern, such as magick mogrify -resize 256x256 *.jpg. It also says the original image file is overwritten unless you change the file suffix with the -format option. That means a watermark applied with mogrify can replace your originals, so work on copies or use the documented -path path option, which writes images to the path you give. The page does not say whether the folder must already exist, so create it first.
The page shows no watermark example, but it lists -annotate and -draw among its options. Our own example, not taken from the page: magick mogrify -path marked -gravity southeast -pointsize 36 -fill white -annotate +20+20 "Your Name" *.jpg. To use it as a procedure, here is our own sequence (it is not from the mogrify page):
- Copy a few photos into a working folder, and create an empty folder named
markedbeside them. - Run the mogrify command above from the working folder.
- Open the results in
markedand check the mark before you run a whole folder.
For a folder of photos, the batch watermarking guide covers the browser route as well.
A route without the command line
Fix Watermark adds a text or logo watermark to one photo or a whole batch in your browser, so your photos are never uploaded. Choose Text or Logo, set the size, opacity and position, and save the result. Free: up to 50 photos per run, and runs are unlimited. No watermark of ours on your photos, ever. Original pixel size; JPEG and WebP are re-encoded at the quality you choose.
Sources
Checked November 17, 2026.
Questions
- How do I add a logo watermark with ImageMagick?
- Use composite to overlap your logo on the photo; the docs show
-gravityand-geometryoptions for placement. The example commands on this page are ours, built from those options. - How do I add text to an image with ImageMagick?
- Use -annotate with an offset, plus -font, -pointsize and -fill. The options page says adding -gravity gives nice results when you omit the offset.
- Is the -watermark option the way to add a logo?
- No. The options page describes it as using percentages of brightness and saturation. We use composite for a logo overlay.
- How do I make an ImageMagick watermark semi-transparent?
- The options page documents -dissolve, which multiplies the overlay's opacity by the percent you give. We found no full semi-transparent logo command in the docs, so the one here is our own example.
- Does mogrify overwrite my photos?
- By default, yes: the mogrify page says the original image file is overwritten. Use -path to write the results to another folder, or work on copies.