The VICIdial soundboard Audio Display field explained

The Audio Display field controls what text shows up on the buttons of a VICIdial Soundboard. It is a small setting with a big effect on how fast an Agent can find the right clip, because it decides whether each button reads as a friendly label, a raw filename, or both, and whether the per-button numbers show at all. It is a board-wide setting, so the choice you make applies to every button on that soundboard rather than per entry.

The three values you can mix

Audio Display takes one or more keywords separated by dashes. FILE displays the filename of the audio file, which is the Audio Filename you set without its extension. NAME displays the Soundboard Name, the descriptive Audio Name you typed for that entry. HIDENUMBERS does something different: rather than adding text, it stops the per-button number from showing on the agent screen. You can use any one of these or all of them together in any combination, and the default is FILE-NAME, so out of the box a button shows both its filename and its descriptive name with the button number still visible.

Because the values combine, FILE-NAME-HIDENUMBERS is perfectly valid and gives you both labels with no button numbers. You separate the keywords with dashes, the same convention used elsewhere on the soundboard screen. The field only affects display; it never changes which file plays or where a button sits, so you can toggle it freely without breaking a working board. For where Audio Display sits among the other soundboard settings, the agent screen configuration guide walks the full screen.

How Audio Display builds a button label

flowchart TD
  A[Audio Display value] --> B{Contains which keywords}
  B -->|FILE| C[Show the Audio Filename]
  B -->|NAME| D[Show the Soundboard Name]
  B -->|HIDENUMBERS| E[Hide the button number]
  C --> F[Render the button label]
  D --> F
  E --> F

The diagram shows that each keyword adds or removes one piece of the label. Keywords are additive, so the final button is just the sum of the FILE, NAME, and HIDENUMBERS choices you included. FILE and NAME each pull from a different field on the entry, while HIDENUMBERS is a toggle that only suppresses the automatic button number. Because nothing here overrides the others, you can freely combine them until the button reads the way you want.

Which combination to pick

For a polished board that agents face all day, raw filenames rarely help, so NAME alone with HIDENUMBERS often reads cleanest and least cluttered. Keep FILE on while you are building and testing, though, so you can confirm each button points at the exact file you meant before you hide the technical detail. HIDENUMBERS is worth turning on once the board is finished, since the numbers are scaffolding agents do not really use. The labels you choose live and die by good Audio Name text, which ties directly into how you set soundboard button types, since headers show their NAME too and depend on the same descriptive text. The whole board renders inside an Agent script, so preview it at agent width before you trust the labels, because text that fits on a wide admin screen can wrap awkwardly on a narrower agent frame.

If you want soundboards that already read clearly to your agents, check VICIfast pricing for a managed VICIdial built for fast agent workflows.