When the plugin path fits
Three conditions, all of them. GMV under $500K with realistic 12-month projection staying under that line. A single comp plan, binary or unilevel, no hybrids and no board cycles. WordPress is your one and only platform; you don't have a separate marketing site, support tooling, or analytics warehouse you'd want to integrate with later. If any of those is false, jump to the headless path.
The reason for the strict filter is that the plugin path's ceiling is real. Performance walls hit around $1M GMV in practice (genealogy queries start exceeding what shared MySQL hosting can serve, and the commission calculation hooks slow checkout for distributor purchases). The work to migrate off the plugin later is roughly the same as the work to do headless from the start, and you'll have built a year of operational habits on the plugin first.
Setup in ninety minutes
Step 1: Install ARM Multi-Level Marketing.
wp plugin install multi-level-marketing --activate
Or through the WordPress admin: Plugins, Add New, search "ARM Multi-Level Marketing." Active install count above 5,000 means the plugin is being maintained. Pin the version explicitly in your wp-config.php updates strategy; this plugin's commission rules can break across major versions and you don't want auto-updates running unattended.
Step 2: Configure the comp plan.
Settings → MLM → Plans. For a binary configuration:
- Compensation type: Binary
- Pay leg: Weaker
- Carry forward: Yes
- Flush cadence: Weekly
- Leg balance ratio: configurable, default 1:1
For unilevel: Compensation type: Unilevel, depth 5 to 9 levels, percentages per level. The plugin handles the basics cleanly. Anything beyond binary or unilevel needs the headless path.
Step 3: Bridge WooCommerce.
Hook order completion to MLM commission calculation through functions.php or a small must-use plugin:
add_action( 'woocommerce_order_status_completed', function( $order_id ) {
do_action( 'mlm_commission_calc', $order_id );
} );
The mlm_commission_calc action is the plugin's documented entry point. Pass the order ID, the plugin walks the upline based on the customer's distributor association, and writes commission ledger entries.
Step 4: Verify with a test order.
Place a test order under a test distributor account. Check the MLM admin's commission ledger; the upline distributors should have commission entries based on the binary or unilevel rules you configured. If the math doesn't match what you intended, fix the plan rules before going live; debugging commissions in production with real distributor money is much harder.
What to watch in operations
Plugin updates can break commission rules. This is the single most common operational pain point on the plugin path. Pin the plugin version, run staging environments for any update, and verify a sample payout cycle on staging before promoting to production. Treat plugin updates the way you'd treat schema migrations on a custom system: deliberately, with rollback plans.
Genealogy queries slow under load. Around 1,000 active distributors, the recursive queries that build the upline-downline tree start hitting MySQL's default join limits on shared hosting. Move to a managed WP host (Kinsta, WP Engine, Pressable) before this becomes acute. Production-grade MLM on shared $10/month hosting is not a viable configuration.
Plan changes are platform changes. When the comp plan needs to evolve (adding a fast-start bonus, changing flush cadence), expect a small custom-development project rather than a configuration change. The plugin's plan flexibility is real but bounded; non-standard rules require code.
When to graduate
Three signals tell you the plugin has run its course: distributor count climbing past 800, a need for hybrid plans, or the moment you start wanting to integrate the platform's data with another tool (HubSpot, Mailchimp, an analytics warehouse). At that point, plan the headless transition. The Headless Architecture guide on this site walks through the bridge pattern; budget two to three weeks of developer time for the migration.
CloudMLM Software is the most common destination for headless transitions from the plugin path; the API surface and PHP SDK are the cleanest fit for WordPress shops familiar with hooks and filters. Business MLM Software is the alternative for networks that need broader plan support during the transition.