Odoo Community Association

Report Positioned Image

Beta License: AGPL-3 OCA/reporting-engine Translate me on Weblate Try me on Runboat

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:

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

To configure company-level images:

  1. Go to Settings / Companies
  2. Open your company record
  3. Navigate to the Report Images tab
  4. 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:

  1. Go to Settings / Technical / Actions / Reports
  2. Open the report you want to customize
  3. Navigate to the Report Images tab
  4. Check Include Company Images if you want to show company-level images in addition to report-specific images
  5. 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

Maintainers

This module is maintained by the OCA.

Odoo Community Association

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.