VICIdial web logo upload rules

VICIdial will not let you point the Web Logo field at any file you like. Instead it builds a dropdown from images that follow a strict naming and location rule, and if your file breaks either rule it simply never appears in the list. Knowing the exact rules saves you the frustration of a perfect logo that no Agent ever sees because the system could not find it. There is no error message to chase, just an empty spot in the list.

The two rules that matter most

First, location: the image must be uploaded to your webserver in the images directory. Second, the filename: it must begin with the prefix vicidial_admin_web_logo. VICIdial scans that directory for files carrying the prefix and lists each one with the prefix stripped off. So an upload named vicidial_admin_web_logoSAMPLE.png shows in the select list as SAMPLE.png. Miss the prefix or drop the file in the wrong folder and the dropdown stays empty of your logo, no error, just absence. Both conditions have to be true at once.

Format and size

The standard logo size is 170 pixels wide by 45 pixels high. PNG is the suggested format, but GIF and JPG are accepted too. PNG is the safe default because transparency lets the logo blend onto whatever background color sits behind it, which on the agent screen is the Standard Row 5 Background color. The shipped default entry is default_new, the standard PNG logo, which is what you replace when you upload your own.

• Location: images directory on the webserver
• Filename prefix: vicidial_admin_web_logo
• Size: 170 wide by 45 high
• Format: PNG suggested, GIF and JPG also work

Why the file does or does not appear

flowchart TD
  A[Upload image file] --> B{In images directory}
  B -->|No| Z[Not listed]
  B -->|Yes| C{Name starts with prefix}
  C -->|No| Z
  C -->|Yes| D[Listed with prefix stripped]
  D --> E[Selectable in Web Logo field]

The diagram is the whole troubleshooting guide in one picture: wrong folder or wrong prefix means not listed, both correct means selectable. When a logo refuses to show up, walk these two checks before anything else, since almost every missing-logo report comes down to one of them.

Common gotcha

The single most common miss is a correct file in the wrong place, or a right place with a typo in the prefix. Copy the prefix exactly, including the underscores, and confirm the upload landed in the images directory and not a subfolder. Once the file lists correctly, the actual selection happens in the Screen Colors template, which is walked through in the post on adding a logo to the VICIdial screen. The full template context, and how it ties into the rest of the layout an Agent script runs in, lives in the agent screen configuration guide.

It is also worth knowing what these rules do not cover. There is no built-in resizer, so an oversized image is shown at whatever dimensions it has rather than being scaled to fit, which is why the 170 by 45 standard matters. And there is no validation that warns you about a bad aspect ratio or a heavy file, the system trusts what you upload. Treat the prep step as part of the rules even though VICIdial does not enforce it, the same way a clean Agent script is a discipline you bring rather than one the system imposes. If you are building those scripts too, the introduction to VICIdial scripts is a good companion read.

Getting the upload right once means your branding shows cleanly on every Agent session from then on, with no further fiddling. If you would rather avoid filename rules and server uploads altogether, a hosted dialer handles it for you, see VICIfast pricing.