How to translate the VICIdial agent screen

If your callers and your reps speak a language other than English, you don't have to live with an English-only interface. The Languages feature lets you swap the wording your Agent sees on screen for a fully translated set of phrases, so the login button, the disposition labels, and every other bit of on-screen text show up in the language your team actually uses. Every phrase keys off the original English string that is hard-coded into the agent screen, so translating is really just a matter of supplying the matching text in your target language.

Create the Language first

Open the Languages section in the admin and add a new Language. The Language ID is the unique handle the system uses internally, so keep it to plain characters with no spaces and nothing fancier than underscores or dashes. Give it a clear Language Description, and set the Language Code to the browser code for your target language, such as fr-fr or es-mx. That code is optional, but if you use a two-letter code that has a matching flag image, VICIdial shows the flag next to the field. The one setting you cannot skip is Active: leave it at the default N and no agent can pick the language, so flip it to Y once you are ready. You can also scope the entry to an Admin User group if you only want certain admins managing it.

Translating doesn't have to be all-or-nothing. Any phrase you leave alone falls back to the default English, so you can translate the entire interface or just reword a handful of strings. For the full picture of how the agent interface fits together, the agent screen configuration guide walks through every screen-level setting alongside Languages.

How a phrase gets translated

flowchart TD
  A[English phrase hard-coded in agent screen] --> B{Language active}
  B -->|No| C[Show default English]
  B -->|Yes| D{Translation exists for phrase}
  D -->|Yes| E[Show translated text]
  D -->|No| C

The diagram shows the lookup that runs for every string the agent screen renders. When the Language is Active and a matching translation exists, the agent sees your wording; when no translation is present, VICIdial quietly falls back to the original English. That fallback is why a partial translation never breaks the screen.

Pull in the agent phrases

To translate the agent screen specifically, use the Populate Language option set to AGENT. That loads only the phrases gathered from the agent web pages, so you are not wading through admin strings your reps never see. From there, fill in the translated text for each phrase. Because translation runs per Agent session, an agent who picks the language at login gets the translated screen for that whole shift, while others keep English. If your reps also follow an on-screen Agent script, remember that script content lives separately from these interface phrases, so plan to translate that script text on its own.

A common gotcha

The most frequent surprise is forgetting to set Active to Y, then wondering why the new language never appears for agents. The second is translating admin phrases when you only meant to touch the agent side, which bloats the list and slows you down. Keep Populate scoped to AGENT for an agent-only translation. If you are building the language from a campaign that uses its own wording, double-check that custom field labels still read correctly, much the way you would when you build an agent script. Always preview the agent screen end to end before you roll the language out to a live floor.

Translating the agent screen is one of the quickest ways to lift comfort and accuracy for a multilingual team, and it costs nothing but a little setup time. If you want a managed VICIdial environment where these screens are ready to translate from day one, take a look at VICIfast pricing.