Bulk Loading vs Adding Leads One at a Time in VICIdial

There are two ways to get a lead into VICIdial: drop a file of thousands through the web lead loader, or type one in by hand from the Add a New Lead screen. They look like the same job at different scales, but they behave differently enough that picking the wrong one wastes time or creates dirty data.

The short version: bulk load when you have a file, add by hand when you have a one-off. The longer version is about what each path checks and what it leaves to you.

Bulk loading: built for volume

The web Lead loader takes a tab, comma, or pipe delimited file, typically up to 8MB, and loads each row into the list table. It can read plain text, CSV, and Excel files. Before you load, the list ID must already exist, and you either put a list ID in every row or use the list ID override on the loader page to stamp the same one onto the whole file.

The loader does almost no data validation on its own. It strips non-digit characters out of the phone and alt phone fields, and that is about it. Everything else, correct fields, real names, sane addresses, is on you to clean before the file goes in. What the loader does give you is optional tooling you turn on per load: a Duplicate check by list, by campaign, or system-wide, time zone lookup, and a USA-Canada number sanity check.

Adding a single lead: built for precision

The Add a New Lead screen is a form. You pick the list from a pulldown, fill in the customer fields, and submit. It is the right tool for a callback you took by phone, a correction, or a quick test Lead you want to dial through to confirm a campaign works. There is no file, no column mapping, no template.

What it does not do is duplicate checking against your existing data the way the loader can. If you hand-key a number that already exists in the list, you can end up with two records for the same person. For one lead that is easy to notice. For a habit, it is how lists rot.

Choosing the path

flowchart TD
  A[New leads to add] --> B{More than a handful?}
  B -->|Yes| C[Use web lead loader]
  B -->|No| D[Use Add a New Lead]
  C --> E[Clean file first]
  E --> F[Enable duplicate check]
  D --> G[Watch for manual dupes]

The deciding question is volume, but the follow-up is always data hygiene. Bulk means clean the file and turn on the checks. Single means stay alert for the dupe you cannot see.

A few practical rules

• Create the list ID before you load anything into it. The loader will not invent it for you.
• Use the list ID override on the loader page so you do not have to repeat the ID in every row.
• If you load the same layout often, build a custom template once so you stop re-mapping columns.
• Add by hand only for true one-offs. Anything repeatable belongs in a file.

For the step-by-step on the loader screen, see loading leads into VICIdial, and for the form path see adding a single lead by hand.

Both paths fit into the broader lifecycle covered in our lists and leads guide. If you want to skip dialer setup entirely and just start loading, VICIfast spins up a secured VICIdial box in under 40 seconds. See pricing.