What the List ID on a Lead Actually Means

Open any lead in VICIdial and you will see a list_id field. It looks like a label, but it is closer to an address. The list ID is how a lead knows which list it lives in, and the list is what connects the lead to a campaign and to a whole stack of settings. Get fuzzy on what the list ID means and a lot of dialer behavior stops making sense.

This is a short tour of what that one number decides.

The list ID is the lead's home

A list is just a container of leads, identified by its ID. That ID is numeric, must be between 3 and 8 characters, must be greater than 99, and cannot start with a 0. You set it when you create the list, and it is fixed from then on. You cannot edit a list ID after submission. The only way to change it is to delete the list and rebuild it under a new number, which also deletes the leads inside, so it is not a casual change.

Every Lead stores the ID of the list it belongs to. That is the link the dialer follows when it needs to know which settings apply to a given record.

What the list ID actually controls

Through its list, a lead inherits a long chain of behavior. The list belongs to exactly one Campaign at a time, and that campaign decides the dial method, pacing, and statuses. The list also carries its own overrides that beat the campaign for these leads: a different script, a different caller ID, different reset times, different call-time windows.

So when you ask why one lead got dialed at 9am and another at noon, or why one saw a different script, the answer usually traces back through the list ID to that list's settings. The lead did not choose. Its list did.

flowchart TD
  A[Lead record] --> B[Has a list_id]
  B --> C[Points to a List]
  C --> D[List belongs to one Campaign]
  C --> E[List has its own overrides]
  D --> F[Dial method and pacing]
  E --> G[Script, CID, reset times]

Setting the list ID at load time

When you load a file, every row needs a list ID. You can put it in each record, or use the List ID Override on the loader page to stamp one ID onto the whole file as it imports. Either way the list must already exist, because the ID is a reference to a real list, not a free-text tag.

If a lead later moves to another list, it carries its custom fields from the list it was first viewed in, but its working settings now come from the new list. The list ID is not just where a lead started, it is where it currently lives.

Why this matters day to day

• Troubleshooting: odd dial behavior almost always traces back to which list a lead is in.
• Reporting: list-level stats only make sense once you know the list ID groups leads, not campaigns.
• Planning: pick list IDs deliberately, because you cannot rename them later without a rebuild.

If you are still setting up your first lists, adding a new list walks through the create screen, and what a VICIdial list is covers the concept from the top.

For how lists and leads fit together end to end, see our lists and leads guide. And if you would rather not stand up a dialer just to learn its quirks, VICIfast provisions a secured VICIdial box in under 40 seconds. View plans.