Pivale Releases Commerce Referral Module for Flexible Incentive Workflows
Aiming to fill a long-standing gap in Drupal Commerce, Pivale has released Commerce Referral, a contributed module designed to support referral systems with independently configurable rewards. Created by backend developer Daniel Johnson to meet client-specific needs, the module is now available for wider community use and extension.
While referral incentives are common in e-commerce platforms, Drupal has lacked a stable, flexible solution. Pivale initially reviewed the older Commerce Referral Discount module but found it limited in scope and outdated—originally built for Drupal 7, with no stable release and a rigid, link-based configuration.
In contrast, Commerce Referral offers a backend-first architecture that works with Commerce Promotions. Referrers and referees can each be assigned separate promotions, with full access to Drupal Commerce’s native controls for usage limits, eligibility conditions, and reward structures.
The module does not impose a predefined interaction model, allowing developers to tailor referral flows—whether triggered by links, actions, or custom logic. Additional conditions can be applied directly to referral instances, such as restricting how many referrals a user can issue or defining business-rule-based constraints.
This decoupled approach positions Commerce Referral as a toolkit for site builders to assemble workflow-specific referral systems without being locked into rigid assumptions. Its compatibility with Drupal Commerce’s core incentive system ensures consistency, while offering greater scope for customisation.
Pivale’s decision to contribute the module reflects a practical ethos: moving from client-driven features to reusable community tools. The agency invites feedback and contributions via the module’s Drupal.org issue queue.
What we needed was not an opinionated end-to-end referral solution, but a flexible foundation that could support different referral models.
To explore or contribute to the module, visit the Commerce Referral project page on Drupal.org.

