# Custom Music on Hold

**Category:** Cloud PBX Features
**URL:** https://www.simtex.com.au/support/kb/cloud-pbx-features/custom-music-on-hold
**Published:** 2024-09-25

This is a step-by-step guide on how to handle custom Music on Hold (MOH) as part of our Cloud PBX platform.

## Introduction

This is a step-by-step guide on how to handle custom Music on Hold (MOH) as part of our Cloud PBX platform.

Custom hold music will play when an inbound or outbound call is placed on hold using your softphone or desk phone.

##### **Upload Audio Files**

We recommend starting by **uploading **the** audio files** that you wish to use for your music on hold.

Uploading the files is an easy process, and our system will automatically convert them for you.

1. Within [MyCloudVoIP](https://account.mycloudvoip.com.au) portal, click **Audio** across the top, then select **Audio Files**.**
![](https://www.simtex.com.au/uploads/banner_13c770b8ad.png)

2. Click the Upload** button on the right-hand side.

3. Enter a meaningful **Name** for your hold music – *Buy-A-Car November Hold*

4. Ensure the **Type** is set to **Music On Hold.
![](https://www.simtex.com.au/uploads/MOH_Upload_97037af014.png)**

5. Find the audio file you want to upload, drag it to the window, or click **Click to Upload**.

6. Click **Save**, and your audio file will be uploaded and converted, ready to use with an audio slot.

##### **Creating Audio Slot**

You will need to create an **Audio Slot** which is a container pointing to your recently uploaded Audio File.**
NOTE: This only needs to be performed once, not each time you change your hold music.**

1. On the left click **Audio Slots.**

2. Click **New** on the right.

3. Type in a meaningful **Name** for your entry, and select **Hold Music** for the *Type**
![](https://www.simtex.com.au/uploads/MOH_Slot_36c7051987.png)
*

4. Hit Save**, then press the **Edit** button on the right of the newly created slot (you can also click the **Label**)

5. Select the **Audio File** you uploaded in the above**
![](https://www.simtex.com.au/uploads/MOH_Edit_Slot_c7987c8efd.png)

6. Hit Save**

##### Configure Custom Audio Selection

##### **NOTE: This only needs to be performed once, not each time you change your hold music.**

1. Go to **Subscriptions** across the top and select the **Call Director** or Cloud PBX **extension** you wish to set custom music on.**
*You will likely need to configure this for all your phones and Call Director accounts.*

2. Next to Audio Selection**, pick the desired Audio Slot**
![](https://www.simtex.com.au/uploads/MOH_Selection_7d8324d239.png)

3. Press Save** – note changing this can sometimes take a couple of minutes to update on our back-end.

##### Future Changes to Music On Hold

Simply **edit** the **Audio Slot** and point it to a new **Audio File** (link).

Firstly, upload the new **Audio File.**

1. Go to the **Audio Slots** page.

2. **Edit** the appropriate **Audio Slot**

3. Select the new **Audio File** from the drop-down menu and click **Save**.

![Linking Audio Slots Screenshot](https://www.simtex.com.au/uploads/Link_Slot_840b239fbe.png)

## Audio Slots vs. Audio Files

**Audio slots** are used to link **audio files** to services such as IVRs or music on hold. Each has a “type,” which can be either **prompt** or **music on hold**.

For example, you may have an **audio slot (prompt)** called *Main Menu*. After uploading the `main-menu.wav` **audio file**, you then configure the **audio slot** to point to the `main-menu.wav` audio file.

Currently, audio slots with a *type* of **prompt** are created by Simtex while we set up and configure your custom IVR.

![Audio Slots vs. Files Diagram](https://www.simtex.com.au/uploads/Audio_Slots_vs_Files_drawio_eaeeed8e7f.png)

Each **audio slot** points to an **audio file**, as shown:

![Audio Slots vs. Files Part 2 Diagram](https://www.simtex.com.au/uploads/Audio_Slots_vs_Files_part_2_drawio_3c7c4b9613.png)

## Related

- Article: https://www.simtex.com.au/support/kb/cloud-pbx-features/custom-music-on-hold
- Category: https://www.simtex.com.au/support/kb/cloud-pbx-features
- Knowledge Base: https://www.simtex.com.au/support/kb
- Full AI reference: https://www.simtex.com.au/llms-full.txt