VICIfast
Product updates

Whitelabeling the VICIdial agent screen

How VICIfast gives your agents a modern VICIdial agent screen in your brand, light and dark, without editing VICIdial itself.

VICIfast Support
··Updated ·4 min read
Call-centre agent wearing a headset — illustration for: Whitelabeling the VICIdial agent screen
Photo by MART PRODUCTION on Pexels

Your agents spend the whole shift on the VICIdial agent screen. On VICIfast you can give them a modern one in your own brand, with your logo, your name and your colours, while the VICIdial underneath stays exactly as it is.

The VICIfast agent screen on a live call, shown with a placeholder brand.
The VICIfast agent screen on a live call, shown with a placeholder brand.

What the agent screen is

The agent screen is the page an agent works in all day. It shows the lead on the line, the call controls, the Disposition buttons and any Agent script attached to the campaign. Out of the box it looks the way VICIdial always has: dense, grey and full of small image buttons. That is fine for an internal team, but it feels out of place when you resell the service under your own name, and new agents take longer to find their way around it.

Before: the stock VICIdial agent screen on the same server.
Before: the stock VICIdial agent screen on the same server.

Two looks to choose from

Every VICIfast server can show one of two agent screens, and you choose per brand:

  • VICIfast screen: a clean, light layout with big call buttons, sheets instead of pop-up boxes, a dark mode each agent can switch on, and a sign-in page with a photo beside the form.
  • Classic VICIdial: VICIdial's own screen, with your logo in the header and a branded sign-in card on your background colour.

Both keep every VICIdial feature. The difference is how much of the page carries your brand.

How it works without touching VICIdial

The VICIfast screen is one line in VICIdial's options.php file, the hook VICIdial provides for adding to its pages. That line loads a script and a stylesheet, and in the browser they rebuild the page around VICIdial's own elements. Every button still calls the same VICIdial function, every field still belongs to the same form, and nothing in VICIdial's code is edited.

That matters when VICIdial updates. Because the program files are untouched, an upgrade does not wipe your branding, and you never end up maintaining a forked copy of the agent screen. If anything ever misbehaves, the page falls back to stock VICIdial instead of breaking. The Classic look is lighter still: it adds your rules to VICIdial's custom.css file, which loads after the default styles.

The branding is per customer because every VICIfast box is Single tenant. There is no shared theme to fight over, so your brand applies only to your server and only your agents ever see it.

What your agents see

  • A status band across the top: green on a live call, amber when paused, blue at disposition.
  • The lead in one card, with the name, the customer's local time and their city.
  • Big tiles for hang up, transfer, park, record and DTMF. A greyed-out tile says why when you hover it, such as "available during a live call".
  • Disposition, callbacks, manual dial and lead search open as sheets over the screen, with VICIdial's own choices inside. Transfer opens a panel right under the lead.
  • Light by default, dark for any agent who prefers it. The Webphone switches with the screen.
The disposition sheet: your campaign's statuses as tiles, each with its code.
The disposition sheet: your campaign's statuses as tiles, each with its code.
The sign-in page: a new photo each day, or your own, beside VICIdial's own login form.
The sign-in page: a new photo each day, or your own, beside VICIdial's own login form.

Setting it up

Branding lives in a whitelabel pack in your VICIfast dashboard. Open Whitelabel, click Create pack, add your logo and company name, pick an accent colour, choose the VICIfast screen, then the login picture and a heading. The preview beside the settings is the real login and agent screen with your pack on it, so you can check it on a sample call, in light and dark, before any agent sees it.

The pack editor: settings on the left, the real sign-in page with your pack on the right.
The pack editor: settings on the left, the real sign-in page with your pack on the right.

When it looks right, apply the pack to a server, or to a project to brand every server in it. VICIfast pushes it to your box, and agents get the new screen the next time they sign in. Every setting is walked through in the step-by-step guide.

flowchart TD
  A[Build a pack: logo, colours, login picture] --> B[Check the real screens in the preview]
  B --> C[Apply the pack to a server or project]
  C --> D[VICIfast adds one line to options.php]
  D --> E{VICIdial files edited?}
  E -->|No| F[Agent signs in and sees your screen]

A way back for agents

Some agents have used stock VICIdial for years. Classic view in the header signs them out, and from then on their browser opens the stock screen. The sign-in page keeps a link to come back to the new one. To move a whole team back, switch the pack to Classic VICIdial and apply it again.

Who this is for

A branded agent screen earns its keep when agents are not your own staff, or when the screen is part of a product you sell on. Resellers want their customers to see one brand. Operators running several clients on separate boxes want each team to see the right look. Because the branding lives on a single box per customer, none of those setups bleed into each other.

Where VICIfast fits

A branded agent screen is one piece of the larger picture in what VICIfast adds to VICIdial. For a closer look at every part of the screen, see the VICIdial theme page. If you also want to brand the phone, see the branded webphone. Since each server provisions in under 40 seconds, you can stand up a branded instance the same day you decide to. The pricing page lists what each plan includes.

About VICIfast

We run VICIdial servers for call centres, so you don’t have to. You get the dialer set up, secured and kept running — we handle the server, the updates and the backups. Bring your own phone carrier at no markup, or use VICIfast Voice, our own US calling and numbers, from $0.0085 a minute. From $49 a month per server.

Questions? Call +1 636 556 0022 and talk to someone who runs dialers.

Citing this article

VICIfast Engineering. “Whitelabeling the VICIdial agent screen”. VICIfast LLC, June 29, 2026. Retrieved from https://vicifast.com/blog/vicifast-branded-agent-screen

Have questions?

Related posts

You might be interested in

Comments

Comments are reviewed before they appear. We never publish your email.

No comments yet - be the first.