Keep track of who referred customers that make purchases.

Creator: Murray Wood (digitalpenguin)

Need help installing this extra?

About Commerce_Referrals

This small module adds an extra page to the Commerce dashboard with a grid to keep partner company information.Each partner is assigned a referral token which they can then use on the end of a product URL to send customers to your shop.


July 1, 2023

Supported Database


Supported Versions
2.7 - Current



Install Install the package and then activate the module in the configuration tab of the Commerce dashboard.

Usage In the Commerce dashboard, click on the Referrals tab and then select Referrers in the subnav.

  • Add details of a partner company that will refer customers to your products.
  • One of the details will be a 'token'. The referrer then adds this token on the end of the URL and their referral will then be recorded.`

System Setting

  • commerce_referrals.tab_position - allows you to set the position in the Commerce nav menu that the referrals tab is added. Value should be an integer.

New in 1.1.0-pl

  • MODX 3 and PHP 8 compatibility
  • Update to new Commerce dispatcher class
  • Improve grid queries
  • Fix bootstrapping
  • Switch to using inbuilt Commerce order fields with twig template rather than injecting an HTML section.
  • Current releases

    View | Download
    July 1, 2023
    2.7 - Current

    View | Download
    April 5, 2019
    2.6 - Current

    View | Download
    May 29, 2018
    2.6 - Current