OdooWiki OCA HUB

Report Labels

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

This module allows you to create self-adhesive label printing actions on any model.

auto_awesome What this module does

AI-generated from the code · Odoo 18.0

Lets you print self-adhesive labels for records of any Odoo model, using configurable label sheets and your own label design. You set it up as a server action and print from a wizard.

This module adds a new kind of automated action that prints self-adhesive labels. On any server action you can choose the new option "Print self-adhesive labels", then pick a label paper format and a label template (a QWeb view) that defines what each label shows.

When the action runs, a "Print Labels" wizard opens. It lists the selected records as lines, each with a quantity (default 1), and lets you set an offset, meaning how many labels to skip at the start of the sheet. Pressing Print generates a PDF label report.

Label sheets are configured under a new menu "Label Paper Formats" in the Reporting menu. For each format you define the underlying paper format plus the label width, height, background colour, padding and margins in millimetres. Only administrators can create or change these formats; other users can read them.

A demo shows a partner address label template and a 3 x 6 label sheet. The module touches ir.actions.server, ir.actions.report and adds the models report.paperformat.label, report.label.wizard and report.label.wizard.line.

Depends on

base_automation

Menus it adds

Label Paper Formats
Models and fields (5)
  • ir.actions.report · extends an existing model
  • ir.actions.server · extends an existing modelstate, label_paperformat_id, label_template_view_id (Label QWeb Template)
  • report.label.wizard · new modeloffset, line_ids, model_id, label_paperformat_id, label_template_view_id (Label QWeb Template)
  • report.label.wizard.line · new modelres_id (Resource ID), quantity, res_name, sequence, wizard_id
  • report.paperformat.label · new modelname, label_width (Label Width (mm)), label_height (Label Height (mm)), paperformat_id (Paper Format), label_margin_top (Label Margin Top (mm)), label_margin_left (Label Margin Left (mm)), label_padding_top (Label Padding Top (mm)), label_margin_right (Label Margin Right (mm)), label_padding_left (Label Padding Left (mm)), label_margin_bottom (Label Margin Bottom (mm)), label_padding_right (Label Padding Right (mm)), label_padding_bottom (Label Padding Bottom (mm)), label_background_color

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: 4 confirmed, 5 with no information of 9 versions.

Sources · Odoo 12.0

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

terminal Installation and usage

OCA documentation · Odoo 18.0

Configuration

Source · Odoo 18.0

Configure your Report Label Paperformat

  • Go to "Settings \> Technical \> Reporting \> Label Paper Format"
  • Create your self-adhesive label paper formats.

You should reuse or create a Paperformat.

Configure your Server action

  • Go to "Settings \> Technical \> Actions \> Server Actions"

Create your label report :

  • In the 'Action to do' field, select 'Print Self-adhesive Labels'
  • In the 'Label Paper Format' field, select your label paper format previously created
  • In the 'Label Qweb Template' create or reuse a QWeb template for your label.

Importante Note

By design, the variable used in this QWeb template must be named record.

Usage

Source · Odoo 18.0
  • In the target model's list view, select the records to print.
  • Click Action and your label report action name.
  • Select the number of labels per record to print, and click Print.

you can optionaly define an offset

The items will be printed in a pdf document.

No verified information in OCA: Installation.

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.