How to add a watermark to a video with FFmpeg
In FFmpeg, the overlay filter places a logo image on a video, and its x and y options set the position; the drawtext filter draws text instead. Both are in FFmpeg's filters documentation, read November 2026. A see-through logo can use colorchannelmixer's aa option, shown below as our own example, which we ran in FFmpeg 8.1.2.
Published . Drafted with AI assistance and checked against the sources linked on this page. How we write our guides.
FFmpeg add watermark image to video with the overlay filter
FFmpeg's filters documentation describes the overlay filter as one that overlays one video on top of another, and the first input is the main video. A logo picture works as the second input. The page states no version number for itself. The documented command below is the documentation's, and we also ran it, with the two commands marked as our own examples, in FFmpeg 8.1.2 on Windows in November 2026.
The documentation's own example for a transparent PNG logo in the bottom left corner is ffmpeg -i input -i logo -filter_complex 'overlay=10:main_h-overlay_h-10' output, where input is your video, logo is your PNG and output is the new file. Our guide to a transparent PNG logo covers preparing the picture.
In FFmpeg's command-line tool (the filters documentation names no version; steps checked November 2026), the documented line breaks down like this:
- Give your video as the first input with
-i, so it is the main video. - Give the logo as the second input with another
-i. - Add
-filter_complexwith the overlay filter and its x and y values. - End the command with the name of the new file.
Everything else on this page is a change to the overlay settings or a different filter.
Set the position with x and y
The overlay filter takes x and y expressions for where the overlaid picture sits on the main video. The documentation says both default to 0, which is the top left corner. The expressions can use these names:
main_w(orW) andmain_h(orH): the width and height of the main video.overlay_w(orw) andoverlay_h(orh): the width and height of the overlaid picture.
For the bottom right corner, the documentation gives overlay=main_w-overlay_w-10:main_h-overlay_h-10, which it describes as 10 pixels from the bottom right corner of the main video. It also gives the named form, overlay=x=main_w-overlay_w-10:y=main_h-overlay_h-10. The 10 pixels belong to the documentation's example. We suggest a margin that suits your video's size, wide enough that the mark does not touch the edge; our YouTube watermark guide says more about where a mark sits well.
FFmpeg add watermark text to video with drawtext
For text, the same documentation lists the drawtext filter. These are the options you need, as it describes them:
text: the text to draw, as UTF-8 characters. It is required unless you give atextfile.fontfile: the font file, with its path. The page says it is mandatory if fontconfig support is disabled. Thefontoption names a font family instead, and defaults to Sans.fontsize: the default is 16.fontcolor: the default is black. Its syntax comes from the Color section of the ffmpeg-utils manual.xandy: the offsets where text is drawn, counted from the top left of the output image, both defaulting to 0. They can usetext_w,text_h,wandh.
The documented example is drawtext="fontsize=30:fontfile=FreeSerif.ttf:text='hello world':x=(w-text_w)/2:y=(h-text_h)/2", which centres the text. The documentation warns that drawtext text can need several levels of escaping, and says a textfile avoids that. For a handle with an at sign or a colon, we suggest the text file.
The documentation does not print a complete command line for drawtext on a video. This one is our own example, built from the documented options: ffmpeg -i input.mp4 -vf "drawtext=text='yourname':fontfile='C\:/Windows/Fonts/arial.ttf':fontsize=30:fontcolor=white@0.5:x=w-text_w-10:y=h-text_h-10" output.mp4. We ran it with FFmpeg 8.1.2 on Windows in November 2026 and it produced an output file; it is still our own example, not a documented command. The fontfile is a Windows font path; on another system, give the path to a font on that system. On our Windows build, the same command without fontfile crashed with a fontconfig error, so we named a font file. The backslash before the colon keeps the drive letter from being read as the end of the option.
Make an FFmpeg watermark see-through
The overlay filter has an option called alpha, but it is not opacity. The documentation says it sets the format of the overlaid video's alpha, as straight or premultiplied, with auto as the default. Setting it will not fade your logo.
For text, there are two documented routes. The Color section of the ffmpeg-utils manual says a colour can be followed by @ and an alpha number between 0.0 (completely transparent) and 1.0 (completely opaque), and that 0xff, fully opaque, is assumed when it is left out. Drawtext also has its own alpha option, a number between 0.0 and 1.0 with a default of 1. The white@0.5 in our drawtext example above is our own use of the colour syntax; the documentation prints no such example, and we ran our example as described above.
For an image, the only route we can point to in the documentation is the aa option of the colorchannelmixer filter, which adjusts the contribution of the red, green, blue and alpha channels to the output alpha channel. Its default is 1 and allowed values run from -2.0 to 2.0. The documentation shows colorchannelmixer only in grayscale and sepia examples, never with overlay. This command is our own example, built from the documented option. We ran it with FFmpeg 8.1.2 on Windows in November 2026, with a PNG that has a transparent background, and it produced an output file:
ffmpeg -i input.mp4 -i logo.png -filter_complex '[1:v]format=rgba,colorchannelmixer=aa=0.5[wm];[0:v][wm]overlay=10:main_h-overlay_h-10' output.mp4
Here aa=0.5 asks for half the alpha. Change the number to taste; our watermark opacity guide explains how strong a mark can be before it hides the picture.
Without the command line: our video tool
If you would rather not write filter expressions, Fix Watermark puts a text or logo watermark on an MP4, MOV or WebM video. Your browser does the work, so the video never leaves your device, and the sound is kept. Drag the watermark in the preview, or pick a spot on the position grid; the preview does not play the video. You need a current Chrome, Edge or Firefox on a computer, or Safari. Open the video watermark tool.
Free: videos up to 60 seconds. Nothing of ours added. Pro removes the limit; your device sets the rest.
Sources
Checked November 17, 2026.
Questions
- How do I add an image watermark to a video with FFmpeg?
- Give FFmpeg your video and the logo as two inputs and use the overlay filter with
-filter_complex. The documentation's example places a transparent PNG in the bottom left corner. - How do I add text to a video with FFmpeg?
- Use the drawtext filter with the
textoption, and afontfileif fontconfig support is disabled. Setfontsize,fontcolor,xandyas needed. The documentation's example centres the words withx=(w-text_w)/2. - Does the overlay filter's alpha option set opacity?
- No. FFmpeg's documentation says it sets the alpha format of the overlaid video: straight, premultiplied or auto.
- How do I make the text watermark semi-transparent?
- The Color syntax allows an
@alpha suffix between 0.0 and 1.0, and drawtext has its ownalphaoption with the same range. Our example useswhite@0.5. - Which FFmpeg version do these commands need?
- The filters documentation states no version for itself. We ran our own examples with FFmpeg 8.1.2 on Windows in November 2026; on another build, try a short clip first.