How to reword phrases on the VICIdial agent screen

Sometimes the default labels on the agent screen just do not match how your floor talks. You do not have to live with awkward wording, and you do not have to translate the whole interface to fix it. A VICIdial Language lets you reword only the phrases you want, while every untouched phrase keeps its default English. The result is a screen that reads the way your Agent expects, without any source-code changes.

How rewording works

Every phrase in a Language keys on the hard-coded English phrase already on the screen. So rewording is just mapping an existing English phrase to your preferred wording. To keep the work focused on agents, create a Language and set Populate Language to AGENT, which loads only the agent-screen phrases instead of the entire admin set. From there you scroll to the phrases that bother you and replace them. Anything you leave alone falls back to English, so a small edit list stays small. This is the gentle cousin of full localization and fits neatly into the broader agent screen configuration guide.

sequenceDiagram
  participant Admin
  participant Language
  participant Screen
  participant Agent
  Admin->>Language: Populate AGENT phrases
  Admin->>Language: Edit chosen English phrase
  Agent->>Screen: Log in with Language assigned
  Screen->>Language: Look up each phrase
  Language-->>Screen: Return reworded or English text
  Screen-->>Agent: Show updated wording

The sequence shows the lookup at login: the screen asks the Language for each phrase and gets back either your reworded version or the original English. Nothing else in the interface is affected.

A practical example

Say your floor calls outbound dials "touches" instead of "calls," and a few of your supervisors keep mistyping a transfer button because its default label is too generic. You would create a Language, set Populate Language to AGENT so only agent-screen phrases load, and then find those two or three English phrases and replace them with your preferred wording. Save, set Active to Y, and assign the Language to the people who need it. The next time those agents log in, the screen reads in their vocabulary while everyone else still sees the defaults. Because every phrase keys on the original English, you can always look back at what the system would normally say, which makes the edits easy to audit and reverse if a wording change does not land the way you hoped.

Keep the edits surgical

The temptation with a populated Language is to start editing everything. Resist it. Reword the handful of phrases that cause real confusion, such as a status button or a transfer label, and leave the rest. A short edit list is easy to review and easy to hand off. Remember to set Active to Y, since it defaults to N and your wording will not show otherwise. If your real goal is reshaping the on-call content agents read rather than a button label, that is the job of a script, and what a VICIdial script is is the better starting point. Rewording shines for the everyday phrases agents read during the Wrap-up and call flow.

When to use it

Rewording is ideal when your team uses internal jargon, when a default phrase is genuinely unclear, or when you want the screen to match a Disposition vocabulary your supervisors already use. Because the change applies to anyone assigned the Language, you can target a single User group or roll it out floor-wide. It is low-risk, fully reversible, and invisible to agents not assigned to it.

Clearer wording is one of the cheapest ways to speed up a new agent. If you want a managed VICIdial where these tweaks are easy to make, check VICIfast pricing.