Report Positioned Image

by Quartile , Odoo Community Association (OCA)

v 18.0 Third Party 4

Availability	Odoo Online Odoo.sh On Premise
Community Apps Dependencies	Show Report Qweb Element Page Visibility
Lines of code	369
Technical Name	`report_positioned_image`
License	AGPL-3
Website	https://github.com/OCA/reporting-engine

You bought this module and need support? Click here!

Report Positioned Image

This module allows you to add positioned images (such as watermarks, logos, or stamps) to PDF reports. Images can be precisely positioned using millimeter coordinates (top, left) and you can control whether they appear on all pages or only the first page.

The module supports two types of images:

Company-level Images: Define images at the company level that can be included in reports by enabling the Include Company Images option
Report-specific Images: Configure specific images for individual reports, filtered by company context and always shown when configured

Images can be assigned to a specific company or left as shared records (without company assignment) for use across multiple companies

Table of contents

Configuration
Bug Tracker
Credits

Configuration

To configure company-level images:

Go to Settings / Companies
Open your company record
Navigate to the Report Images tab
Add images with position settings:
- Upload an image - width defaults to 50mm and height is automatically calculated to maintain the original aspect ratio
- Top (mm): Distance from the top of the page
- Left (mm): Distance from the left edge of the page
- Width (mm): Width of the image (changing this auto-adjusts height)
- Height (mm): Height of the image (changing this auto-adjusts width)
- Respect Image Ratio: When enabled (default), changing width or height automatically adjusts the other dimension to maintain aspect ratio. Uncheck for manual control of both dimensions.
- First Page Only: Check to show only on the first page
- Company: Automatically set to the current company when creating from the company form. To create shared images, leave empty.

To configure report-specific images:

Go to Settings / Technical / Actions / Reports
Open the report you want to customize
Navigate to the Report Images tab
Check Include Company Images if you want to show company-level images in addition to report-specific images
Add report-specific images in the list with the same position settings as above

Note: By default, images maintain their aspect ratio. When you upload an image, it’s automatically sized to 50mm width with proportional height. You can then adjust either dimension and the other will update automatically to prevent distortion.

Bug Tracker

Bugs are tracked on GitHub Issues. In case of trouble, please check there if your issue has already been reported. If you spotted it first, help us to smash it by providing a detailed and welcomed feedback.

Do not contact contributors directly about support or help with technical issues.

Credits

Authors

Quartile

Contributors

Quartile <https://www.quartile.co>
- Tatsuki Kanda
- Aung Ko Ko Lin

Maintainers

This module is maintained by the OCA.

OCA, or the Odoo Community Association, is a nonprofit organization whose mission is to support the collaborative development of Odoo features and promote its widespread use.

This module is part of the OCA/reporting-engine project on GitHub.

You are welcome to contribute. To learn how please visit https://odoo-community.org/page/Contribute.

Please log in to comment on this module

The author can leave a single reply to each comment.
This section is meant to ask simple questions or leave a rating. Every report of a problem experienced while using the module should be addressed to the author directly (refer to the following point).
If you want to start a discussion with the author, please use the developer contact information. They can usually be found in the description.