How to add a watermark in darktable
In darktable 5.6, the watermark module overlays an SVG watermark such as a signature, and the manual says it also accepts PNG bitmaps. Your own watermarks go in the watermarks folder inside darktable's configuration directory; opacity, scale, rotation and alignment are separate controls in the module.
Published . Drafted with AI assistance and checked against the sources linked on this page. How we write our guides.
The darktable watermark module
The watermark module page in the darktable 5.6 user manual says the module can overlay an SVG watermark like a signature on the image. It adds that watermarks are standard SVG documents that can be designed using Inkscape, and that you can also use bitmap (PNG) images. The manual lists the module's purpose as creative. The steps below come from the 5.6 manual; the watermark page does not split by platform.
The page does not say where the module appears in the darkroom or how to switch it on, so we do not describe that here.
darktable watermark folder: where a custom watermark file goes
The manual says user-designed watermarks should be placed into the watermarks folder in the darktable configuration directory. The module's marker control lists the available watermarks, shows each file's extension (png or svg) in brackets, and has a reload button to update the list with any newly added watermarks. The page does not give the full path of the watermarks folder, and does not state separately where PNG files go.
The configuration directory depends on how you installed darktable, per the manual's configuration directory page:
| Platform | Configuration directory |
|---|---|
| Windows | %LOCALAPPDATA%\darktable (for example C:\Users\<username>\AppData\Local\darktable) |
| macOS | $HOME/.config/darktable |
| Linux (package manager or AppImage) | $HOME/.config/darktable |
| Linux (Flatpak) | $HOME/.var/app/org.darktable.Darktable/config/darktable |
| Linux (snap) | $HOME/snap/darktable/current/ |
The page adds that the directory can be changed with the --config-dir option. The watermarks folder sits inside the configuration directory per the watermark page; the configuration directory page does not list it among its notable files and folders.
In darktable 5.6 (steps checked November 2026):
- Save your watermark file into the watermarks folder in the darktable configuration directory.
- In the watermark module, use the reload button to update the list of available watermarks.
- Choose your file with the marker control.
For a transparent logo to use as a PNG, our guide to a transparent PNG logo covers the file.
darktable text watermark and template settings
The module has a text field that takes up to 511 characters, printed where a watermark references it. The manual says an example watermark using that text is supplied as simple-text.svg. Other text controls are the font (default "DejaVu Sans Book") and the colour of the text. The manual notes that text is used by watermarks that reference the matching variables, such as $(WATERMARK_TEXT), $(WATERMARK_COLOR) and $(WATERMARK_FONT_FAMILY), so a custom SVG file has to reference them to show what you type in the text field.
darktable watermark size, opacity and alignment
These are separate controls on the module page:
- opacity: the opacity of the watermark's rendering.
- rotation: the rotation angle of the watermark.
- scale: the scale in per cent, relative to the option chosen in scale on. The options are image (the default), larger border, smaller border, height and advanced options.
- alignment: controls to align the watermark to any edge or the centre of the image, with x offset and y offset giving a pixel-independent offset from that alignment on each axis.
The manual gives no recommended values. Our GIMP watermark guide shows the same job in another editor, and our guide to Lightroom watermarks covers that app.
If you align the watermark to an edge and also use the framing module, the manual says the watermark may appear within the frame instead of on the actual image. It says you can manually adjust the module order so the framing module comes after the watermark module in the pixelpipe.
Export the watermarked photos from darktable
The export module page says the module exports selected images. In the darkroom view, the image being edited is exported if no other images are selected in the filmstrip. Its settings include target storage, filename template, on conflict, file format, quality (default 95), set size and max size. The on conflict options include create unique filename, overwrite, overwrite if changed and skip. We suggest the unique filename option so an export does not overwrite a file you meant to keep.
The manual pages we used do not describe a batch method for watermarks beyond exporting selected images. For a folder of photos, Fix Watermark adds text or a logo to many photos at once in your browser, and nothing is uploaded. 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. Our batch watermarking guide has the steps.
Sources
Checked November 8, 2026.
- docs.darktable.org/usermanual/5.6/en/module-reference/processing-modules/watermark
- docs.darktable.org/usermanual/5.6/en/preferences-settings/config-directory
- docs.darktable.org/usermanual/5.6/en/module-reference/utility-modules/shared/export
Questions
- Which darktable version do these steps come from?
- The darktable 5.6 user manual. Its watermark page does not split by platform and gives no version in which the module was added.
- Where do I put a custom watermark file in darktable?
- The manual says user-designed watermarks go in the watermarks folder in the darktable configuration directory. Use the reload button to update the list of available watermarks.
- Can darktable use a PNG as a watermark?
- Yes. The manual says watermarks are standard SVG documents, and that you can also use bitmap (PNG) images.
- How do I change the size and opacity of a darktable watermark?
- Use the module's scale and opacity controls. Scale is a percentage relative to the option chosen in scale on.
- Why does my darktable watermark appear inside the frame?
- The manual says that with an edge alignment and the framing module, the watermark may sit within the frame. It says you can adjust the module order so the framing module comes after the watermark module.