Unilevel Plan Setup Documentation

Complete guide to configure and implement Unilevel MLM compensation plan

Last updated: February 1, 2024 • Version: 2.1.0 • Difficulty: Intermediate

Unilevel Plan Overview

The Unilevel MLM compensation plan allows distributors to sponsor unlimited frontline distributors, with commissions paid on multiple levels deep. This plan is popular for its simplicity and unlimited width potential.

Key Characteristics:

• Unlimited frontline (width) sponsorship
• Fixed commission depth (typically 5-10 levels)
• Decreasing commission percentages at deeper levels
• Simple to understand and explain
• Encourages team depth development

How Unilevel Plan Works

In a Unilevel plan, each distributor can sponsor unlimited direct downlines (level 1). Commissions are earned on the personal sales of downlines across multiple predetermined levels, with commission percentages typically decreasing at each subsequent level.

Unilevel Plan Example Structure

Distributor A (You)
├── Level 1 (10%): Distributor B, C, D, E... (Unlimited)
│   ├── Level 2 (5%): Distributor F, G, H...
│   │   ├── Level 3 (3%): Distributor I, J...
│   │   │   ├── Level 4 (2%): Distributor K...
│   │   │   └── Level 5 (1%): Distributor L...
│   │   └── ...
│   └── ...
└── ...

Commission Calculation: 
Level 1: 10% of personal volume from B, C, D, E...
Level 2: 5% of personal volume from F, G, H...
Level 3: 3% of personal volume from I, J...

Advantages of Unilevel Plan

✓ For Companies

• Predictable commission costs
• Easy to administer and explain
• Encourages depth development
• Suitable for product-focused businesses

✓ For Distributors

• Unlimited earning potential from width
• Simple to understand compensation
• Benefit from team depth
• No balancing requirements

Prerequisites

Before configuring the Unilevel plan, ensure you have the following prerequisites in place:

1. System Requirements

MLMPortal.in software version 2.0 or higher
MySQL 5.7+ or PostgreSQL 10+ database
PHP 7.4+ with required extensions
Minimum 2GB RAM for production environment
SSL certificate for secure transactions

2. Business Configuration

Company profile and settings configured
Product catalog with point values (PV)
Payment gateway integration
User roles and permissions defined
Tax settings configured

Important: Ensure you have a complete backup of your database before making any configuration changes to the compensation plan settings. Unilevel plans with deep levels can generate complex genealogy structures.

Unilevel Plan Configuration

Follow these steps to configure the Unilevel plan in your MLMPortal.in admin panel.

Step 1: Access Plan Settings

Login to your MLMPortal.in admin panel
Navigate to Settings → Compensation Plans
Click on Add New Plan
Select Unilevel Plan from the plan types

Step 2: Basic Plan Configuration

Configure the basic settings for your Unilevel plan:

// Unilevel Plan Basic Configuration
{
  "plan_name": "Standard Unilevel Plan",
  "plan_type": "unilevel",
  "status": "active",
  "description": "Standard Unilevel compensation plan with 7 levels depth",
  "start_date": "2024-02-01",
  "currency": "INR",
  "max_levels": 7,
  "unlimited_width": true
}
                

Parameter	Description	Required	Default
`plan_name`	Unique name for your Unilevel plan	Yes	-
`plan_type`	Must be "unilevel"	Yes	-
`max_levels`	Maximum commission depth levels	Yes	5
`unlimited_width`	Allow unlimited frontline sponsors	Yes	true

Step 3: Plan Structure Settings

Configure the Unilevel plan structure and placement rules:

// Unilevel Structure Configuration
{
  "structure_settings": {
    "auto_placement": "enabled",
    "placement_method": "sponsor_tree",
    "allow_repositioning": false,
    "genealogy_view": "unilevel_tree",
    "compression_enabled": true,
    "compression_method": "skip_inactive"
  }
}
                

Commission Settings

Configure commission rates and calculation methods for your Unilevel plan.

Unilevel Commission Configuration

// Commission Settings
{
  "commission_settings": {
    "calculation_basis": "personal_volume",
    "commission_type": "percentage",
    "levels": [
      {
        "level": 1,
        "percentage": 10,
        "requirement": "none",
        "max_commission": null
      },
      {
        "level": 2,
        "percentage": 5,
        "requirement": "active",
        "max_commission": 5000
      },
      {
        "level": 3,
        "percentage": 3,
        "requirement": "active",
        "max_commission": 3000
      },
      {
        "level": 4,
        "percentage": 2,
        "requirement": "qualified",
        "max_commission": 2000
      },
      {
        "level": 5,
        "percentage": 1,
        "requirement": "qualified",
        "max_commission": 1000
      }
    ],
    "level_qualification": {
      "personal_volume": 100,
      "team_volume": [500, 1000, 2000, 5000, 10000]
    }
  }
}
                

Parameter	Description	Example Value
`calculation_basis`	Personal volume or group volume	personal_volume
`commission_type`	Percentage or fixed amount	percentage
`levels`	Commission rates for each level	Array of level objects
`level_qualification`	Requirements for each level	Volume requirements

Advanced Commission Settings

Configure advanced commission calculation options:

// Advanced Commission Settings
{
  "advanced_settings": {
    "differential_commission": {
      "enabled": true,
      "calculation": "difference_between_levels"
    },
    "commission_capping": {
      "daily_cap": 10000,
      "weekly_cap": 50000,
      "monthly_cap": 200000
    },
    "carry_forward": {
      "enabled": false,
      "period": "monthly"
    },
    "commission_hold": {
      "enabled": true,
      "hold_period_days": 7
    }
  }
}
                

Level Settings & Qualification

Configure level-specific settings and qualification requirements.

Level Configuration

// Level Configuration
{
  "level_configuration": {
    "total_levels": 7,
    "level_requirements": [
      {
        "level": 1,
        "rank": "distributor",
        "personal_volume": 100,
        "personal_sales": 1,
        "frontline_count": 0,
        "team_volume": 0
      },
      {
        "level": 2,
        "rank": "senior_distributor",
        "personal_volume": 200,
        "personal_sales": 2,
        "frontline_count": 3,
        "team_volume": 1000
      },
      {
        "level": 3,
        "rank": "executive",
        "personal_volume": 300,
        "personal_sales": 3,
        "frontline_count": 5,
        "team_volume": 5000
      }
    ],
    "rank_benefits": {
      "bronze": {"bonus_rate": 2, "requirements_met": "level_3"},
      "silver": {"bonus_rate": 5, "requirements_met": "level_5"},
      "gold": {"bonus_rate": 10, "requirements_met": "level_7"}
    }
  }
}
                

Level	Commission %	Personal PV	Team PV	Frontline
Level 1	10%	100	-	1+
Level 2	5%	200	1,000	3+
Level 3	3%	300	5,000	5+
Level 4	2%	400	10,000	7+
Level 5	1%	500	25,000	10+

Compression Rules

Configure compression settings to handle inactive distributors and optimize commission calculations.

Compression Configuration

// Compression Rules
{
  "compression_settings": {
    "enabled": true,
    "compression_method": "skip_inactive",
    "inactivity_period": 30,
    "compression_criteria": {
      "personal_volume": 0,
      "time_period": "monthly"
    },
    "compression_benefits": {
      "maintain_commission_levels": true,
      "allow_compressed_qualification": true
    },
    "reactivation_rules": {
      "allow_reactivation": true,
      "reactivation_period": 90,
      "reactivation_fee": 100
    }
  }
}
                

Compression Methods:

skip_inactive - Skip inactive members in genealogy
remove_inactive - Remove inactive members completely
maintain_structure - Keep structure but don't pay commissions
dynamic_compression - Automatic compression based on activity

Compression Example

How compression works in a Unilevel structure:

Before Compression

You
├── A (Active)
├── B (Inactive)
│   └── C (Active)
└── D (Active)
    └── E (Inactive)
        └── F (Active)

Commission: You earn from A, C, D, F

After Compression

You
├── A (Active)
├── C (Active) - moved up from under B
└── D (Active)
    └── F (Active) - moved up from under E

Commission: You earn from A, C, D, F
(Same distributors, optimized structure)

Qualification Rules

Configure qualification requirements for distributors to earn commissions at different levels.

Qualification Settings

// Qualification Configuration
{
  "qualification_settings": {
    "minimum_joining_product": "starter_pack",
    "active_status_requirements": {
      "personal_volume": 100,
      "time_period": "monthly",
      "maintenance_fee": 0
    },
    "level_advancement": {
      "auto_advancement": true,
      "verification_required": false,
      "advancement_period": "instant"
    },
    "rank_requirements": {
      "bronze": {
        "levels_qualified": 3,
        "team_structure": "3_active_frontline"
      },
      "silver": {
        "levels_qualified": 5,
        "team_structure": "5_active_frontline"
      },
      "gold": {
        "levels_qualified": 7,
        "team_structure": "7_active_frontline"
      }
    }
  }
}
                

Maintenance Requirements

Configure requirements for distributors to maintain their qualification status:

// Maintenance Settings
{
  "maintenance_settings": {
    "volume_requirements": {
      "personal_volume": 100,
      "team_volume": 1000,
      "rollup_volume": true
    },
    "time_periods": {
      "qualification_period": "monthly",
      "grace_period_days": 15,
      "renewal_period": "monthly"
    },
    "penalties": {
      "demotion_enabled": true,
      "demotion_levels": 1,
      "commission_hold": true
    }
  }
}
                

Testing & Validation

Test your Unilevel plan configuration before going live.

Test Commission Calculation

// Test Unilevel Commission Calculation
POST /api/v1/commission/test/unilevel
{
  "plan_id": "unilevel_001",
  "user_id": "user_123",
  "test_scenario": {
    "level_volumes": [5000, 3000, 2000, 1000, 500],
    "personal_volume": 1000,
    "team_structure": {
      "level1_count": 5,
      "level2_count": 25,
      "level3_count": 125
    }
  }
}

// Response
{
  "status": "success",
  "total_commission": 1250,
  "commission_breakdown": {
    "level_1": 500,
    "level_2": 375,
    "level_3": 300,
    "level_4": 75,
    "level_5": 0
  },
  "qualification_status": {
    "levels_qualified": 4,
    "current_rank": "silver"
  }
}
                

Validation Checklist

Test commission calculations at each level
Verify level qualification rules
Test compression functionality
Validate rank advancement
Test genealogy tree generation
Verify commission capping and limits

Troubleshooting

Common issues and solutions for Unilevel plan configuration.

Common Unilevel Issues

• Commissions not calculating for deep levels
• Qualification not updating automatically
• Compression not working correctly
• Genealogy tree performance issues with large teams
• Rank advancement not triggering

Debug Commission Calculation

// Enable Unilevel debug mode
UPDATE system_settings 
SET value = 'true' 
WHERE setting_key = 'unilevel_debug_mode';

// Check level qualification status
SELECT * FROM user_level_qualifications 
WHERE user_id = ? AND plan_id = ?;

// Verify genealogy structure
SELECT * FROM genealogy_unilevel 
WHERE ancestor_id = ? AND plan_id = ? 
ORDER BY level_depth;
                

Performance Optimization

For large Unilevel organizations, consider these performance optimizations:

// Performance Settings
{
  "performance_optimization": {
    "genealogy_caching": true,
    "cache_duration": 3600,
    "batch_processing": true,
    "batch_size": 1000,
    "commission_calculation_time": "off_peak",
    "level_limits": {
      "max_levels_display": 10,
      "real_time_calculation_levels": 5
    }
  }
}
                

API Integration

API endpoints for Unilevel plan integration and automation.

Core API Endpoints

// Create Unilevel Plan
POST /api/v1/plans/unilevel
Content-Type: application/json
Authorization: Bearer {api_key}

{
  "plan_name": "Standard Unilevel",
  "max_levels": 7,
  "commission_rates": [10, 5, 3, 2, 1, 1, 1],
  "settings": { ... }
}

// Calculate Unilevel Commission
POST /api/v1/commission/calculate/unilevel
{
  "user_id": "user_123",
  "plan_id": "unilevel_001",
  "period": "2024-02"
}

// Get Unilevel Genealogy
GET /api/v1/genealogy/unilevel/{user_id}?levels=5

// Check Level Qualification
GET /api/v1/qualification/levels/{user_id}
                

Webhook Events

Unilevel plan specific webhook events for real-time notifications:

// Level Advancement Webhook
{
  "event": "level.advanced",
  "data": {
    "user_id": "user_123",
    "plan_id": "unilevel_001",
    "old_level": 3,
    "new_level": 4,
    "qualification_date": "2024-02-01",
    "achieved_rank": "silver"
  },
  "timestamp": "2024-02-01T10:30:00Z"
}

// Commission Calculation Webhook
{
  "event": "commission.calculated.unilevel",
  "data": {
    "user_id": "user_123",
    "plan_id": "unilevel_001",
    "total_commission": 1250,
    "period": "2024-02",
    "level_breakdown": {
      "level_1": 500,
      "level_2": 375,
      "level_3": 300,
      "level_4": 75
    }
  },
  "timestamp": "2024-02-01T23:59:00Z"
}
                

Need Help with Unilevel Plan Setup?

Our technical support team is available to help you configure and optimize your Unilevel compensation plan.

Contact Support

Documentation

Related Guides