OdooWiki OCA HUB

Report Positioned Image

report_positioned_image folder_open OCA/reporting-engine open_in_new
Reporting License: AGPL-3

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

auto_awesome What this module does

AI-generated from the code · Odoo 19.0

Add images such as watermarks, logos or stamps to PDF reports, positioned precisely in millimetres. Images can be set per report or per company, and can be limited to the first page.

This module lets you place images on the PDF output of any report. For each image you set its name, the picture itself, the distance from the top and left edge in millimetres, its width and height, and whether it should appear only on the first page.

You configure images in two places: - On a report itself (Reports settings): a "Report Images" tab lists the images for that report and has an "Include Company Images" option to also show the images defined at company level. - On the company form: a "Report Images" tab lists images shared by that company.

Automatic behaviours shown by the code: - When you upload an image, a default width of 50 mm is applied and the height is calculated to keep the original proportions. - If "Respect Image Ratio" is on, changing the width recalculates the height and vice versa. - Top and left positions cannot be negative, and width and height must be greater than zero; otherwise Odoo blocks saving with an error. - An image can be left without a company to apply to all companies, or tied to one company. When created from a company form, the company cannot be changed to another one.

Access is read-only for regular users; only system administrators can create, edit or delete these images. A multi-company rule keeps images visible only for the allowed companies.

Depends on

webreport_qweb_element_page_visibility
Models and fields (3)
  • res.company · extends an existing modelreport_positioned_image_ids (Company Images)
  • ir.actions.report · extends an existing modelinclude_company_images, report_positioned_image_ids (Report Images)
  • report.positioned.image · new modelname, image, width (Width (mm)), height (Height (mm)), pos_top (Top (mm)), pos_left (Left (mm)), company_id, first_page_only, respect_image_ratio

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-03
Confirmed (verified in repository and branch) Estimated (unverified) No information

Confirmation status: 2 confirmed, 7 with no information of 9 versions.

Sources · Odoo 19.0

Confirmed on 2026-11-03 in branch 19.0 of OCA/reporting-engine.

terminal Installation and usage

OCA documentation · Odoo 19.0

Configuration

Source · Odoo 19.0

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.

No verified information in OCA: Installation, Usage.

info

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.