leads-lists
Custom field
An extra data column you add to a VICIdial list to store your own information beyond the standard name and phone fields.
A custom field is an extra piece of data you attach to a lead list beyond the built-in fields like name, address, and phone. VICIdial gives you a fixed set of standard columns, but most real campaigns need to carry their own information, and custom fields are how you do that without bending the standard fields out of shape.
Common uses are a lead score, the product a lead asked about, the date of a prior quote, or an account number from your own system. You decide the field name and type when you build the list, then map your file columns to them with the lead loader during import. The fields stick with the list, so every record loaded into it gets the same shape.
Once a custom field exists, it shows up where it matters. You can display it on the agent script so the agent sees context the moment the call connects, which makes the opening line feel personal instead of generic. You can also use it inside a lead filter to target only the records that match, like calling everyone with a score above a threshold first. That combination turns a flat list into a smart calling plan.
Do not confuse a custom field with the vendor lead code, which is a single standard column meant for your outside record ID. Custom fields are flexible and plural; the vendor lead code is one fixed slot. Plan your custom fields before the first lead loader run, because adding them after data is already loaded means reworking the list and re-importing, which is far more effort than getting the layout right at the start.
A small habit pays off here: write down what each custom field means before you build it. Six months later, a column labeled with a vague name leaves everyone guessing, and a lead filter built on a misunderstood field can target the wrong people. Keep the names plain, document the values you expect, and your custom fields stay useful long after the person who set them up has moved on.
Related terms
Agent script
An agent script is the on-screen text and talking points VICIdial shows the agent during a call, often filled in with live lead details.
Lead
A single contact record in VICIdial holding a phone number plus fields like name and address, the basic unit your campaigns dial.
Lead filter
A SQL-based rule on a campaign that decides which leads the dialer is allowed to call, narrowing a list to only the records you want.
Lead list
A named collection of leads that campaigns dial from, identified by a list ID and assigned to one or more campaigns.
Lead loader
The VICIdial tool that imports a file of phone numbers and contact data into a list, mapping each column to the right database field.
Vendor lead code
A free-text field on each lead that holds the original ID from whoever supplied the lead, used to match records back to the source vendor or system.