OdooWiki OCA HUB

Loyalty multi gift

loyalty_multi_gift folder_open OCA/sale-promotion open_in_new
Sale License: AGPL-3

This module allows to define multiple reward products on promotions.

auto_awesome What this module does

AI-generated from the code · Odoo 18.0

Adds a new "Multi Gift" reward type to loyalty programs, letting you offer several gift products with quantities in a single promotion instead of just one.

This module extends the loyalty and promotions features in Odoo so that a promotion reward can give away more than one product.

  • On a loyalty reward, a new reward type "Multi Gift" becomes available alongside the standard reward types.
  • When that type is selected, a "Multi Gift" section appears on the reward form with an editable list of gift lines. Each line has a quantity, a default gift product, and a set of gift options (products) that can be chosen.
  • The default gift is automatically taken from the first product in the gift options list, and the reward description is generated automatically, showing "Multi Gift" or "Multi Gift - [product names]".
  • The reward is flagged as a multi gift only when the type is Multi Gift and at least one gift line exists.
  • The reward kanban view also shows the generated description for multi gift rewards.
  • The module touches the loyalty reward and loyalty program records, and adds a new gift line record used only for configuration. Access to that configuration is limited to system administrators.
  • Internal safeguards prevent gift lines from being duplicated when a reward or program is saved.

Depends on

loyalty

Required by other modules

Models and fields (3)
  • loyalty.reward · extends an existing modelmulti_gift, reward_type, loyalty_multi_gift_ids (Gift list)
  • loyalty.program · extends an existing model
  • loyalty.reward.product_line · new modelreward_id, reward_product_ids (Gift Options), reward_product_quantity (Quantity), reward_default_product_id

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 16.0

Confirmed on 2026-11-03 in branch 16.0 of OCA/sale-promotion.

terminal Installation and usage

OCA documentation · Odoo 18.0

To configure multiple product rewards:

  • Go to Sales \> Products \> Discount & Loyalty and select or create a new one.
  • Choose the criteria of appliance you want to use and the minimum quantities, that will be used to calculate the times the rewards can be applied.
  • On the Program Type field choose Multi Gift.
  • You'll see a now the Gift list on which you can add the products you want to give away and the quantities for each of them.

An example:

> [TABLE]

With a minimum quantity of 3, for every 3 units of products that fulfill the domain we'd get 3 units of A and 2 of B. So if the valid products quantities are 11, we'd get 3 of product A and 2 of product B.

This module is a base to be used by extra modules that use it in sale orders, PoS orders, etc.

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.