---
title: 'Default music on hold'
summary: 'A small catalog of audio files that the PBX can pick from as the tenant-wide hold-music default. The actual default is selected on the PBX settings page.'
section: features
tags:
  - crud
  - telephony
  - audio
updated: '2026-06-17'
---

> The **Default music on hold** page is a small catalog of audio files marked as candidates for the PBX-wide hold-music default. The file selected on the [PBX settings](pbxes.md) page becomes the fallback played whenever a queue or call flow step does not specify its own override.

## Overview

This is a specialized subset of [Music on hold](music_on_holds.md): the same audio-file format and upload flow, but only these files can be picked as the tenant-wide default. Regular music-on-hold files instead attach to a specific queue or step.

## What it does

Uploading here only adds a file to the catalog. To make it the live default, open the [PBX settings](pbxes.md) page, Defaults tab, pick the file from the *Music on hold* picker, then save and push the configuration. Replacing the audio of the active default takes effect immediately, with no preview or staging.

> [!TIP]
> Test a new track without disturbing live calls: upload it here, override one queue's Music on hold picker to try it, and switch the PBX default only after that goes well.

## See also

- [Music on hold](music_on_holds.md) - the regular per-queue and per-step hold-music catalog.
- [PBX settings](pbxes.md) - where the actual default is selected.
- [Queues](queues.md) - the most common surface that respects the PBX default.
- [Sound files](sound_files.md) - the dashboard that groups all three audio types.

```yaml fields
name:
  label: Name
  tab: General
  hint: 'Display name shown in the PBX-Defaults Music on hold picker. Use a name that describes the track or its intended mood.'
comment:
  label: Comment
  tab: General
  hint: 'Internal note, such as the source, license, or upload date.'
audio_data:
  label: 'Sound file'
  tab: General
  hint: 'The audio file to upload. Accepted formats are MP3, WAV, FLAC, and AAC up to 20 MB.'
```