photoshop_recipe_batch_watermark
Apply a text or logo watermark to every image in a folder and export watermarked JPEGs. Replaces the clunky record-an-action + File > Automate > Batch workflow. Use when: the user wants to watermark many photos at once (copyright text, studio logo). Do NOT use when: watermarking a single open document (use photoshop_create_text_layer / photoshop_place_image directly) or removing watermarks (not supported). Returns: { ok, summary, output_paths, details: { processed, failed: [{ file, error }] } }. Files that fail are skipped, not fatal. Preconditions: assets_dir exists; either text or logo_path given. No active document required. Side effects: writes one JPEG per source image; source files are never modified.
Parameters
| Name | Type | Required | Description |
|---|---|---|---|
| assets_dir | string | yes | Absolute path to the folder of images to watermark. Subdirectories are NOT recursed. Allowed extensions: jpg/jpeg/png/tif/tiff/webp. |
| text | string | — | Watermark text (e.g. "© Jane Doe 2026"). White, semi-transparent. Required unless logo_path is given. |
| logo_path | string | — | Absolute path to a logo image (transparent PNG recommended). Required unless text is given. If both are given, text wins. |
| position | string | — | Watermark placement. Default bottom_right. |
| opacity | number | — | Watermark layer opacity 0-100. Default 40. |
| margin_px | number | — | Distance from the chosen edge(s) in pixels. Default 24 (ignored for center). |
| font_size | number | — | Text watermark size in pixels. Default 0 = auto (4% of each image height, min 8px). |
| scale_pct | number | — | Logo watermark width as a percentage of image width (1-100). Default 15. Logo mode only. |
| quality | number | — | JPEG quality on the Photoshop 1-12 scale. Default 10. |
Official
- Batch watermarkWatermarks every image in a folder; originals are never touched.
Community recipes
Nothing here yet. Be the first to share one.
Share a recipe