Finding which campaigns use a VICIdial screen label

Screen labels are reusable templates, which is great until you forget how many places one of them is plugged into. Change a field name or hide a field on a shared label, and you change the agent screen for every Campaign using it. The label has no idea you only meant to fix one campaign; it pushes the same field names and behaviors to everyone assigned to it. VICIdial gives you a simple safeguard against that surprise: a list that tells you exactly which campaigns are on a given screen label before you touch anything. It is a small section that saves a lot of explaining after the fact.

Where to find the list

Open the screen label in the admin screen labels area. Below the 19 field label entries you will find a section called Campaigns Using This Screen Label. It displays all campaigns that currently have this screen label active. That is the whole blast radius of any edit you make, listed in one place, with no guessing and no cross-referencing every campaign by hand. A screen label is assigned to a campaign on the campaign modification page through the Agent Screen Labels pulldown, so this list is simply the reverse view of those assignments: instead of asking which label a campaign uses, you are asking which campaigns use a label. For the bigger picture of how labels, fields, and campaigns relate, the agent screen configuration guide walks through the whole chain.

Check this list before any meaningful change: renaming a field, switching one to ---HIDE---, or marking one ---REQUIRED---. If the label is on three live campaigns, that edit lands on all three the next time an Agent loads the screen.

Check before you edit

flowchart TD
  A[Open screen label] --> B[Read Campaigns Using This Screen Label]
  B --> C{Used by more than one campaign}
  C -->|Yes| D[Clone label for the one that differs]
  C -->|No| E[Edit the label directly]
  D --> F[Edit the clone safely]

The flow keeps you out of trouble. If a label is shared and only one campaign needs the change, clone the label and assign the copy rather than editing the shared one and breaking the others. If the label is used by exactly one campaign, or by none, you can edit it freely. The list is what tells you which path you are on before you commit.

Why it saves you

This list is also your cleanup tool. If a screen label shows no campaigns, you can retire it without worry. If it shows campaigns you thought were retired, you have just found stale Lead routing worth investigating. It also makes auditing painless: before a compliance review or a big campaign migration, you can confirm at a glance that no orphaned label is still feeding fields to a campaign you forgot about. Screen labels sit in the same agent-facing layer as scripts, so if you are still mapping out how all these admin pieces connect, assigning a script to a campaign shows the same assign-and-reverse-lookup pattern in action, which makes screen labels click faster.

Glance at Campaigns Using This Screen Label first and screen-label edits stop being scary. If you want a managed VICIdial where this kind of admin clarity is built in, see VICIfast pricing.