This module was written to add watermarks (backgrounds) to PDF reports. Because of the way wkhtmltopdf handles headers and footers in the current versions, it is quite impossible to have a background for the complete page using HTML and CSS. That is why this module inserts the image at the PDF level.
auto_awesome What this module does
AI-generated from the code · Odoo 19.0Adds a watermark (a PDF or image file) to QWeb PDF reports, either set per report, taken from the company settings, or computed by an expression. The watermark is applied to every page of the generated PDF.
This module lets you put a background watermark on PDF reports generated by Odoo. You upload a PDF or an image file and it is merged onto each page of the printed report.
Where it appears: - On each report configuration (the technical form of a report action), new fields appear for PDF-type reports: a watermark file, a watermark expression, and a checkbox to use the company watermark. - On the company form, a new Watermark field lets you upload a company-wide watermark file.
How the watermark is chosen, in order:
- If a watermark file is set on the report itself, that file is used.
- Otherwise, if the option to use the company watermark is enabled, the watermark of the company of the printed document is used (falling back to the current company).
- Otherwise, an expression can return the watermark data; it has access to env and docs.
Automatic behaviour: - The watermark file is merged onto every page of the resulting PDF, sized to the page. - If the watermark file is an image, it is converted to PDF first. - If the watermark PDF has no pages, or cannot be read, the report is printed without a watermark and an error is logged. - Only the first page of a multi-page watermark PDF is used.
A demo report called "Watermark Demo report" on users shows the feature using the company logo as watermark.
Depends on
Required by other modules
Models and fields (2)
- res.company · extends an existing modelpdf_watermark (Watermark)
- ir.actions.report · extends an existing modelpdf_watermark (Watermark), use_company_watermark, pdf_watermark_expression (Watermark expression)
Text generated by AI (DeepSeek) from reading the Odoo 19.0 code on GitHub; it may contain mistakes, so check the code before deciding. View the code on GitHub
Availability by version
Reviewed: 2026-11-03Confirmation status: 8 confirmed, 1 with no information of 9 versions.
Sources · Odoo 17.0
Confirmed on 2026-11-03 in branch 17.0 of OCA/reporting-engine.
terminal Installation and usage
OCA documentation · Odoo 19.0Usage
Source · Odoo 19.0To use this module, you need to:
- go to your report
- select a PDF or image to use as watermark. Note that resolutions and size must match, otherwise you'll have funny results
- You can also fill in an expression that returns the data (base64 encoded) to be used as watermark
To use the Company watermark, you need to:
- go to settings --\> company --\> update info
- upload an pdf watermark
- go to settings --\> technical --\> reporting --\> reports
- Select the report where you want to use it.
- On the 'Advanced Properties' tab of the notebook check 'use company watermark'
Demo And demo report is available (if you have demo data installed) on the users form view.
- go to Configuration --\> users
- Select an users
- Click the print button --\> Watermark Demo report.
No verified information in OCA: Installation, Configuration.
Installation instructions, the distribution package, dependencies and configuration steps are not shown because they have not yet been verified in the module documentation for any version.
Data imported from GitHub: this sheet reflects the latest catalog review, not a live lookup. Always check the module documentation and staging before installing in production.