OdooWiki OCA HUB

Report QWeb PDF Cover

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

This module allows for front and back covers to be added to the generated PDF reports. They can be added as a separate page, at the beginning or the end of the report, but they can also overlap the first and last page of the actual report, respectively.

auto_awesome What this module does

AI-generated from the code · Odoo 18.0

Add front and back cover pages to QWeb PDF reports. For each report you can upload a cover PDF, choose whether it appears as a separate page or overlaps the first/last page of the report.

This module extends the configuration of PDF reports so that a cover page can be placed before and/or after the report content.

On the report configuration form (the same screen where you set the report type and attachment), new options appear when the report type is a QWeb PDF report: - Use front cover and Use back cover: turn the covers on for that report. - Overlap Front Cover / Overlap Back Cover: when enabled, the cover is merged on top of the first or last page of the report instead of being added as a separate page. - Front Cover PDF / Back Cover PDF: upload the PDF file to use as the cover, shown with a PDF preview widget.

When the report is generated, the system loads the uploaded cover files, checks that each contains at least one page, and warns in the log if a cover is empty or has more than one page (only the first page is used). It then builds the final PDF by inserting the front cover before the report pages and the back cover after them, or by merging them onto the first and last report pages when overlap is selected. If no usable cover is found, the report is returned unchanged.

The module only touches the report action model ir.actions.report and its configuration view; it does not change the content of the reports themselves.

Depends on

web
Models and fields (1)
  • ir.actions.report · extends an existing modelback_cover_pdf (Back Cover PDF), use_back_cover, front_cover_pdf (Front Cover PDF), use_front_cover, back_cover_overlap (Overlap Back Cover), front_cover_overlap (Overlap Front Cover)

Text generated by AI (DeepSeek) from reading the Odoo 18.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 18.0

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

terminal Installation and usage

OCA documentation · Odoo 18.0

To add a cover to a report, you need to access to the report's configuration, more specifically to the Advanced Properties tab. There, you will find two checkboxes, one for the front cover and another for the back cover. They both work the same, so let's focus on the front cover with an example.

  • You must check the Use Front Cover checkbox to enable the front cover. You will see that a new checkbox and a PDF file widget appear.
  • If you want the front cover to overlap with the first page of the PDF report, you should also check the Overlap Front Cover checkbox. Leave it unchecked if you don't want the front cover to overlap with the first page.
  • The last step would be to upload the PDF file that will be used as the front cover. You can do this by clicking on the PDF file widget and selecting the file.
  • Important! The file must be a PDF file, and it should have only one page. If it has more pages, only the first one will be used.

No verified information in OCA: Installation, Configuration.

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.