Skip to Content
SessionPBX

Music on Hold

Upload a WAV or MP3 file to replace the existing hold music for your SessionPBX workspace. The file loops while callers are on hold, waiting in a queue, parked, or waiting in a conference.

Custom music on hold is available on all SessionPBX plans, with no separate add-on. Only workspace administrators can change it. Call queues still require Teams Business.

Upload your music

  1. Sign in to your workspace as an administrator.
  2. Open Admin → Settings.
  3. Select the Music on hold tab.
  4. Drag a WAV or MP3 into the upload area, or select Choose audio file.
  5. Use the audio player to preview the selected file.
  6. Select Upload and use.

The uploader shows your selected filename and size. Use Choose another file to replace the selection, or the remove button to clear it before uploading.

SettingSupported value
File typeWAV or MP3
Maximum file size50 MB
Audio preparationAutomatic

You do not need to change the sample rate or convert stereo to mono yourself. After selecting Upload and use, the uploader shows Preparing audio and Uploading audio as it converts your file to 8 kHz, 16-bit PCM, mono WAV and saves it. Keep the page open until the success message appears. Long tracks must also fit within 50 MB after conversion, which is about 54 minutes of audio.

After saving, Current music shows the saved WAV filename and an audio player lets you preview it. An MP3 keeps its name with a .wav extension. Changes may take a few moments to reach the phone system.

Switching Workspace Settings tabs keeps your selected file until you upload it or choose another file. The preview pauses when you leave the Music on hold tab. Upload and use saves the music selection; the General tab’s Save settings button saves the general workspace fields.

Where the music plays

One music selection applies throughout the workspace:

  • Normal hold when a team member places a caller on hold
  • Waiting in any call queue
  • Parked calls
  • Conference waiting music

The uploaded file replaces the existing music in each of these places and repeats until the caller leaves hold or waiting. There is no separate music selection for individual queues. Voicemail greetings and call-flow announcements keep their own audio.

The new selection applies when music next starts. Callers already listening to hold music can continue hearing the previous track until they leave hold.

Restore the default music

Open Admin → Settings → Music on hold and select Restore default music. The workspace returns to its default hold music after the change reaches the phone system.

Check the result

  1. Save your music and allow a few moments for it to apply.
  2. Make a test call and place the caller on hold.
  3. Listen long enough to confirm the file repeats.
  4. Resume the call and confirm both people can hear each other.
  5. If you use queues, call a queue and check the waiting music too.

If an upload is rejected, check that you selected one WAV or MP3 file no larger than 50 MB. If it cannot be read, try exporting it again from an audio editor. If the prepared audio is too large, choose a shorter track. A rejected upload leaves the current music unchanged and keeps your selection available to retry or replace.

Last updated on