How to Bulk-Delete Leads From a List in VICIdial

When a Lead list fills up with bad records - disconnected numbers, exhausted Lead entries, or rows you imported by mistake - you don't want to delete them one row at a time. VICIdial's lead management tools let you remove leads in bulk from a single list, with a few guardrails that stop you from wiping live data by accident. This guide walks through where the delete action lives, the two rules you have to satisfy before it will run, and how to target only the rows you actually mean to remove.

Where bulk delete lives

Open the admin area and go to Lists, then pick the list you want to clean up. The Basic Lead Management Tools page gives you three actions for that list: move leads, update lead Status (lead status), or delete leads. Delete is the one we're after here. The same delete action also lives on the Advanced Lead Management Tools page, which adds more ways to narrow down exactly which rows you remove - by vendor code, owner, date, and more. For a single list with simple needs, the basic page is faster.

Two rules before you can delete

The tool won't touch a list unless two conditions are true:

• The list must currently be inactive. An active list is one a running Campaign is dialing, and the dialer assumes nobody is pulling rows out from under it. Set the list to inactive first, and let the hopper drain for a moment.
• The list must hold fewer than 100,000 leads. Past that count the bulk tools refuse to run, because a single huge delete can lock tables and stall live calling on other campaigns.

We cover the why behind the first rule in why a list must be inactive before bulk changes, and the count cap in what the 100,000-lead limit means. If your list is over the cap, split it first and delete from the pieces.

Narrowing what gets deleted

You rarely want to delete every row. The page lets you sub-divide the list by lead status and by called count, so you can target only the records you mean. A few common cuts:

• Delete only leads with a status like DNCC or a final Disposition you're done working.
• Delete leads whose called count is above a threshold - rows you've already dialed many times with nothing to show.
• Leave anything tied to a DNC (do not call) match in place so you don't lose your compliance record.

Always check the row count the filter reports before you commit. If it shows far more rows than you expected, your status or called-count filter is probably too broad - tighten it before submitting.

The delete flow

flowchart TD
  A[Open Lists] --> B[Pick the list]
  B --> C{Is it inactive?}
  C -->|No| D[Set list inactive]
  D --> E{Under 100k leads?}
  C -->|Yes| E
  E -->|No| F[Split list first]
  E -->|Yes| G[Choose status / called count filter]
  F --> G
  G --> H[Review row count]
  H --> I[Run Delete]
  I --> J[Leads removed]

Deletion is permanent - there is no undo, so confirm the filters show the count you expect before you submit. If you only want to clear out stale records but keep dialing the good ones, look at bulk-updating lead status or moving the rows to a holding list instead. Either way you keep the data and can still pull reports on it later.

Run dialers that keep up with your data

Bulk lead tools are one small part of what a VICIdial admin does day to day. For the full set of bulk operations and how they fit together, see VICIdial admin bulk tools explained. And if you'd rather not babysit the server itself, VICIfast hosts VICIdial for you on a dedicated box, provisioned in under 40 seconds - check VICIfast pricing to see the plans.