Pivale Releases Commerce Referral Module for Flexible Incentive Workflows

Pivale Releases Commerce Referral Module for Flexible Drupal Commerce Incentives

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.

Daniel Johnson, backend developer, Pivale

To explore or contribute to the module, visit the Commerce Referral project page on Drupal.org.

Disclosure: This content is produced with the assistance of AI.

Note: The vision of this web portal is to help promote news and stories around the Drupal community and promote and celebrate the people and organizations in the community. We strive to create and distribute our content based on these content policy. If you see any omission/variation on this please reach out to us at #thedroptimes channel on Drupal Slack and we will try to address the issue as best we can.

Related Organizations

Upcoming Events

Latest Opportunities