# Music on Hold

# Overview

The **Music on Hold** page defines music-on-hold classes, playback format, streaming source, order, and default behavior. Open it from **Configuration > More Configuration > Music On Hold**.

The page works against the tenant currently selected in the top bar. The screenshots and demo rows were captured in the **Canistracci OIL** tenant.

<figure id="bkmrk-music-on-hold-list-p">![Music on Hold list page in the Canistracci OIL tenant.](https://manual.mirtapbx.com/uploads/images/gallery/2026-06/dLXmusic-on-hold-list.png)<figcaption>Music on Hold list page in the Canistracci OIL tenant.</figcaption></figure>## Working with objects

<table id="bkmrk-taskhow-to-do-it-add"><thead><tr><th>Task</th><th>How to do it</th></tr></thead><tbody><tr><td>Add</td><td>Select the New music on hold class action, complete the form, and select Save.</td></tr><tr><td>Edit</td><td>Open the music on hold class from the list by selecting its name, number, or row action. Change the form and select Save.</td></tr><tr><td>Delete</td><td>Select the row checkbox and use Delete Selected, or open the music on hold class and select Delete, then confirm.</td></tr></tbody></table>

## Page functions

<table id="bkmrk-actiondescription-do"><thead><tr><th>Action</th><th>Description</th></tr></thead><tbody><tr><td>Download</td><td>Downloads or exports the currently available data.</td></tr><tr><td>New Music On Hold</td><td>Opens the creation form for a new music on hold.</td></tr><tr><td>Delete Selected</td><td>Deletes the selected rows after confirmation.</td></tr></tbody></table>

## List columns

<table id="bkmrk-columndescription-na"><thead><tr><th>Column</th><th>Description</th></tr></thead><tbody><tr><td>Name</td><td>Display name used in lists and references.</td></tr><tr><td>Media Files</td><td>File upload or file name used by the object.</td></tr><tr><td>Custom</td><td>Object setting shown by the form.</td></tr><tr><td>Randomize order</td><td>Object setting shown by the form.</td></tr><tr><td>Default</td><td>Object setting shown by the form.</td></tr></tbody></table>

## Demo records

The tenant contains 1 documentation demo record for this page: Docs Demo MOH 1.

## Deleting records

Before deleting a music on hold class, check references from call flows, destinations, schedules, reports, or provisioning objects. MiRTA PBX asks for confirmation before the delete is submitted.

# Create and Edit Music on Hold

Use this page when creating a new music on hold class or editing an existing music on hold class from **Configuration &gt; Music on Hold**.

The form screenshots below are separated by block where the application exposes separate sections. Complete the required values, review routing or destination references, and save the record.

## Form sections

<table id="bkmrk-sectiondescription-i"><thead><tr><th>Section</th><th>Description</th></tr></thead><tbody><tr><td>Information</td><td>Core identity and routing fields for the object.</td></tr><tr><td>Streaming source</td><td>Settings shown in the Streaming source block.</td></tr></tbody></table>

### Information

<figure id="bkmrk-information-section-">![Information section on the edit form.](https://manual.mirtapbx.com/uploads/images/gallery/2026-06/spqmusic-on-hold-form-section-1.png)<figcaption>Information section on the edit form.</figcaption></figure>Core identity and routing fields for the object.

### Streaming source

<figure id="bkmrk-streaming-source-sec">![Streaming source section on the edit form.](https://manual.mirtapbx.com/uploads/images/gallery/2026-06/2VWmusic-on-hold-form-section-2.png)<figcaption>Streaming source section on the edit form.</figcaption></figure>Settings shown in the Streaming source block.

## Main fields

<table id="bkmrk-fielddescription-nam"><thead><tr><th>Field</th><th>Description</th></tr></thead><tbody><tr><td>Name:</td><td>Display name used in lists and references.</td></tr><tr><td>Randomize order</td><td>Object setting shown by the form.</td></tr><tr><td>Use standard application</td><td>Object setting shown by the form.</td></tr><tr><td>MOH application:</td><td>Object setting shown by the form.</td></tr><tr><td>URL / Custom command:</td><td>Object setting shown by the form.</td></tr><tr><td>Volume:</td><td>Object setting shown by the form.</td></tr><tr><td>Format:</td><td>Object setting shown by the form.</td></tr><tr><td>Streaming Engine:</td><td>Mode selector that changes the behavior of the object.</td></tr><tr><td>Default</td><td>Object setting shown by the form.</td></tr></tbody></table>

## Saving and deleting

<table id="bkmrk-taskhow-to-do-it-cre"><thead><tr><th>Task</th><th>How to do it</th></tr></thead><tbody><tr><td>Create</td><td>Select the new action from the Music on Hold list, fill the required fields, and select Save.</td></tr><tr><td>Edit</td><td>Open the existing music on hold class, update the needed fields, and select Save.</td></tr><tr><td>Delete</td><td>Before deleting a music on hold class, check call-flow, destination, schedule, report, provisioning, or integration references. Use the row delete action or the form delete action when available, then confirm.</td></tr></tbody></table>