How to remove a track from a Music On Hold class

When a track no longer belongs in your VICIdial Music on hold class — an old promo message, a song you are done with — you remove it from the class without disturbing the rest. VICIdial makes this a single click, but there is an important nuance about what gets deleted and what stays. This walkthrough covers both.

Removing the track from the class

1. Open admin, Music On Hold, and click MODIFY on the class.
2. In the Audio Files section, find the track you want gone.
3. Click the DELETE link next to that file. It removes only that one file from the class.
4. Check the Rank of the remaining files and adjust if you need to close a gap in the play order.
5. Wait up to a minute for VICIdial to regenerate the hold-music config.

The DELETE link works one file at a time, so removing several tracks means clicking it once per file. There is no bulk remove on the class screen.

What DELETE does and does not touch

The DELETE link in the class detaches the file from that class only. It does not remove the file from the audio store, and it does not affect any other class that uses the same file. The file stays available, so you can re-attach it later or use it elsewhere. If you actually want the file gone from the system, that is a separate action in the audio store's File to Delete control.

flowchart TD
  A[Click DELETE on a track] --> B[Remove file from class list]
  B --> C[Conf rebuild on next cycle]
  C --> D[Track no longer plays here]
  A --> E{File still in audio store}
  E -- Yes --> F[Reusable in other classes]
  E --> G[Delete in store to remove fully]

There is also an automatic side of cleanup worth knowing. VICIdial keeps the hold-music folder in sync with the class: any file in the folder that is not listed in a class gets removed on its own. So once you detach a track, the playback engine on Asterisk stops serving it as One-way audio to held callers, even though the master copy in the audio store is untouched.

Tidy up the remaining order

After a removal, the Rank order can have a gap — for example, you delete Rank 2 and now go 1, 3, 4. Playback still loops fine, but it is tidier to renumber the survivors so the order reads cleanly. Use the Rank pulldown on each remaining file. The same class can feed any Campaign or queue that points at it, so a clean playlist pays off across the board.

If you do want a file gone from the store entirely, what is the VICIdial audio store explains where files live and how deletion there differs from detaching a track.

Removing tracks is routine hold-music upkeep. For the bigger audio picture — prompts, voicemail, and TTS (text to speech) — read our VICIdial audio prompts, voicemail, and TTS guide.

VICIfast ships a dialer with Music On Hold and the audio store already configured, so editing a playlist is just clicks. See our pricing to get started.