> ## Documentation Index
> Fetch the complete documentation index at: https://docs.voxo.co/llms.txt
> Use this file to discover all available pages before exploring further.

# Music On Hold

> This guide provides step-by-step instructions on how to add, edit, and delete Music on Hold (MoH).

## This guide provides step-by-step instructions on how to add, edit, and delete Music on Hold (MoH). MoH plays music or messages to callers on hold, enhancing their experience with entertainment or information while they wait. Music on Hold can also be applied to specific call flows, such as call groups and consultative transfers.

<Warning>
  This document applies to the following user roles within Omnia:

  Account Administrator
  Partner Administrator
</Warning>

### Accessing Music On Hold

1. **Navigate to Music On Hold:**
   Go to the [Admin Portal](https://app.voxo.co/dashboard) and sign in.
   Click the **Phone System** tab to expand it, then select **Music On Hold**.

![](https://colony-recorder.s3.amazonaws.com/files/2024-06-06/2fe82768-bcbf-4bd1-8ec8-1d1b2eb2aaee/stack_animation.webp)

### Adding New Music on Hold

2. **Add New Music on Hold:**

* Click **Add New**.

![](https://ajeuwbhvhr.cloudimg.io/colony-recorder.s3.amazonaws.com/files/2024-06-06/df0e4f15-d21a-4e91-88b9-6f3863c06564/ascreenshot.jpeg?tl_px=665,0\&br_px=1525,480\&force_format=jpeg\&q=100\&width=860\&wat_scale=76\&wat=1\&wat_opacity=1\&wat_gravity=northwest\&wat_url=https://colony-recorder.s3.amazonaws.com/images/watermarks/F43F5E_standard.png\&wat_pad=732,130)

3. **Name the Music on Hold:**

* Enter a name for the music on hold in the **Name** field.

![](https://ajeuwbhvhr.cloudimg.io/colony-recorder.s3.amazonaws.com/files/2024-06-06/2d03e894-4fd2-40d4-ab5b-6777792e558d/ascreenshot.jpeg?tl_px=134,0\&br_px=993,480\&force_format=jpeg\&q=100\&width=860\&wat_scale=76\&wat=1\&wat_opacity=1\&wat_gravity=northwest\&wat_url=https://colony-recorder.s3.amazonaws.com/images/watermarks/F43F5E_standard.png\&wat_pad=402,92)

4. **Set as Default Tenant:**

* Check the **Set as Default Tenant** box if you want this music on hold to be the default for the tenant.

![](https://ajeuwbhvhr.cloudimg.io/colony-recorder.s3.amazonaws.com/files/2024-06-06/f6b26739-671b-43e8-ae48-17332951675d/ascreenshot.jpeg?tl_px=49,0\&br_px=908,480\&force_format=jpeg\&q=100\&width=860\&wat_scale=76\&wat=1\&wat_opacity=1\&wat_gravity=northwest\&wat_url=https://colony-recorder.s3.amazonaws.com/images/watermarks/F43F5E_standard.png\&wat_pad=402,150)

5. **Select a Media File:**

* Choose a media file from the **Mediafiles** dropdown. This will be an already saved file in the media files section of the portal.

![](https://colony-recorder.s3.amazonaws.com/files/2024-06-06/1f5c86db-a216-4d09-a702-2f5749cf3c79/stack_animation.webp)

6. **Add a New Media File:**

* Click **Add a Mediafile** to record or upload a new media file if needed.
* Use the controls to record or upload the media file. This will open additional options.

![](https://colony-recorder.s3.amazonaws.com/files/2024-06-14/ad08e109-cf75-4e4b-bbb9-251163a6c2f3/stack_animation.webp)

7. **Additional Options**:

* **Playback**: Click to play the media file.
* **Press and Hold To Record:** Click and hold to record a message.
* **Upload File**: Click to add an existing audio file.
* **Cancel Changes**: Click to revert to previous settings.
* **Enter a name**: Type the name in the **Mediafile** name field before saving.
* **Save Changes**: Click to save the recorded or uploaded file. This media file will now be available to choose from and select in the dropdown.

![](https://ajeuwbhvhr.cloudimg.io/colony-recorder.s3.amazonaws.com/files/2024-06-14/dd63dc04-6a36-405a-9b60-116923ae63a2/user_cropped_screenshot.jpeg?tl_px=0,66\&br_px=855,547\&force_format=jpeg\&q=100\&width=860\&wat_scale=76\&wat=1\&wat_opacity=1\&wat_gravity=northwest\&wat_url=https://colony-recorder.s3.amazonaws.com/images/watermarks/F43F5E_standard.png\&wat_pad=200,269)

8. **Save the Music on Hold:**

* Click **Create**.
* Click **Yes** to confirm and save your changes.

![](https://colony-recorder.s3.amazonaws.com/files/2024-06-06/e21e79c6-1159-438e-ac49-f99b1eb909aa/stack_animation.webp)

<Note>
  When a Music on Hold has more than one media file, you can choose how its tracks play: in a fixed order or shuffled randomly.
</Note>

### Editing Existing Music on Hold

9. **Edit Existing Music on Hold:**

* Click on the **Music on Hold** you want to edit or click the **Edit** button next to it.
* Make your edits.
* Click **Save**.
* Click **Yes** to confirm and save your changes.

![](https://colony-recorder.s3.amazonaws.com/files/2024-06-06/50346054-cbae-42b4-9859-1c8b5eb0a80d/stack_animation.webp)

<Note>
  If the previous audio keeps playing after you update the track, remove the old media file from the Music On Hold record, select the new file, and save.
</Note>

### Deleting Music on Hold

10. **Delete Music on Hold:**

* Click the **Delete** button next to the Music on Hold.
* Confirm the deletion by clicking **Yes**.

![](https://colony-recorder.s3.amazonaws.com/files/2024-06-06/39f5aa37-25d4-440f-95b9-a533e087fefb/stack_animation.webp)

### Search and Sort

11. **Search for Music on Hold:**

* **Search Bar**: Quickly find specific items by typing the name or a keyword in the search field. The system will filter the list based on your search input, Displaying the relevant results.
* **Sort**: Click the sort icons next to column headers to arrange items in ascending or descending order.

![](https://colony-recorder.s3.amazonaws.com/files/2024-06-13/3bfbe959-2d56-40fd-a868-1cdb7062d1c3/stack_animation.webp)