Quick Reference

Setting Name hopper_level
Default Value 20
Recommended 20 to 200 depending on agent count and lead volume
Impact Level High
Location Admin > Campaigns > [Campaign] > Dial Settings
ViciStack Module List Management & Optimization

hopper_level

What Hopper Level Does

The target number of leads maintained in the dialing hopper (queue) at any given time. VICIdial continuously refills the hopper from your lead lists to maintain this count. Setting too low causes the dialer to pause while hopper is refilled; too high consumes memory and may lock in stale leads.

| Center Size | Recommended Value | Notes |

| --- | --- | --- |

| 10–25 Agents | 20 to 200 depending on agent count and lead volume | Start conservative, monitor for 48 hours before adjusting |

| 25–100 Agents | 20 to 200 depending on agent count and lead volume | Scale gradually — larger operations amplify effects of misconfiguration |

| 100–500 Agents | 20 to 200 depending on agent count and lead volume | Consult ViciStack optimization team for enterprise-scale tuning |

How to Change This Setting

  • Navigate to Admin > Campaigns

  • Select campaign

  • Find Hopper Level field

  • Enter target hopper size (agents * dial_level * 2-3x buffer is a good formula)

  • For 20 agents at dial level 2: 80-120 is appropriate

  • Submit

Common Problems

Value too low (under 10) causes frequent hopper-empty pauses in dialing

Value too high locks leads in hopper that could be recycled sooner

Hopper not refilling despite leads in list indicates a dial_status_filter mismatch

ViciStack Module

ViciStack’s List Management & Optimization module automatically monitors and optimizes hopper_level based on real-time performance data from your operation. Instead of manual tuning, ViciStack continuously analyzes call outcomes, agent performance, and contact rates to recommend and implement optimal values — often catching configuration drift before it affects your numbers.

Frequently Asked Questions

What does hopper_level do in VICIdial? +

The target number of leads maintained in the dialing hopper (queue) at any given time. VICIdial continuously refills the hopper from your lead lists to maintain this count. Setting too low causes the dialer to pause while hopper is refilled; too high consumes memory and may lock in stale leads.

What is the recommended value for hopper_level? +

The recommended range for hopper_level is 20 to 200 depending on agent count and lead volume. The out-of-box default is 20. Note that optimal values vary by operation size, campaign type, and carrier — use ViciStack's automated tuning to find your exact optimal configuration.

Can ViciStack automatically optimize hopper_level for me? +

Yes. ViciStack's List Management & Optimization module monitors hopper_level continuously and alerts you when the value drifts outside optimal range. On qualifying plans, ViciStack can automatically adjust this setting based on real-time performance data — no manual intervention required.

Related Settings

dial_status_filter View setting → lead_recycling View setting → list_order View setting → max_hopper_calls View setting →

Related Blog Posts

Technical Guide How to Build an AI-Powered Outbound Call Center From Scratch in 2026 Read article → Industry Insights Call Center ROI Formula: How to Calculate and Improve Read article → Industry Insights 75+ Call Center Statistics for 2026: Industry Data, Benchmarks, and Trends Read article →

Part of the Complete VICIdial Implementation Guide and VICIdial Performance Optimization Guide

Need Help Optimizing Your VICIdial?

Get a free performance audit from our team of VICIdial experts. We'll identify quick wins and long-term improvements.

Get Your Free Audit →