---
title: "Audio library"
description: "Upload MP3 or WAV files to Calls > Settings > Audio Library, then reuse them for IVR menu greetings, queue hold music, and voicemail prompts, or use text-to-speech instead."
doc_type: how-to
audience: merchant
sidebar_position: 20
# Provenance — do not edit by hand; used by re-run diffing and redirects.
confluence_page_id: "4160356354"
confluence_url: "https://ultracart.atlassian.net/wiki/spaces/ucdoc/pages/4160356354"
last_updated_in_confluence: "2026-02-18T17:45:53.931Z"
---
The Audio Library is a centralized repository for all audio files used in your UltraCart Calls system. Upload custom audio for IVR menu greetings, queue hold music, voicemail prompts, and other voice prompts. Audio files uploaded here can be referenced from menus, queues, and voicemail mailboxes throughout your configuration.

## Overview

Instead of uploading the same audio file in multiple places, the Audio Library gives you a single location to manage all your voice prompts and hold music. Upload a file once, then select it wherever you need it -- in a queue greeting, an IVR menu prompt, a voicemail mailbox, or as your default hold music.

## Uploading audio files

1.  Navigate to **Calls > Settings > Audio Library**.
2.  Select **Upload New Audio File**.
3.  Choose one or more files from your computer.
4.  The files upload and appear in the library list.

### Supported formats

-   **MP3** (`.mp3`)
-   **WAV** (`.wav`)

### File size limit

Each file can be up to **10 MB**. Files exceeding the limit are rejected with an error message.

:::tip

For hold music, keep files between 1-3 minutes long. Longer files increase load times without significantly improving the caller experience. For greetings and prompts, keep them under 30 seconds.

:::

### Uploading multiple files

You can select and upload multiple files at once. Each file is added to the library as a separate entry.

## Where audio files are used

Audio files from the library can be selected in these locations:

| Location | Purpose |
| --- | --- |
| [IVR menu](./ivr-menus-auto-attendant.md) greeting | The prompt callers hear when the menu answers (e.g., "Press 1 for Sales...") |
| [Queue](./call-queues.md) greeting | The message callers hear when entering a queue |
| [Queue](./call-queues.md) hold music | Music that plays while callers wait in the queue |
| [Queue](./call-queues.md) no-agent message | The message callers hear when no agents are available |
| [Voicemail](./voicemail.md) greeting | The prompt callers hear before leaving a voicemail |
| [Voicemail](./voicemail.md) followup | The message callers hear after leaving a voicemail |
| [Agent](./agent-management.md) unavailable greeting | The message callers hear when an agent is unavailable (when voicemail is disabled) |

In each of these locations, you choose between uploading an audio file (from the library) or using text-to-speech.

## Text-to-speech alternative

Anywhere an audio file can be used, text-to-speech (TTS) is available as an alternative. With TTS, you type the message text and select a voice (male or female). The system generates the audio automatically.

TTS is convenient for:

-   Quick setup when you don't have professional recordings yet
-   Frequent changes to greeting text
-   Testing new prompts before recording professional audio

For a polished caller experience, professional recordings generally sound better than TTS. Consider using TTS initially and replacing with recorded audio as your system matures.

## Managing audio files

### Viewing the library

Navigate to **Calls > Settings > Audio Library** to see all uploaded files. Each file displays its filename with playback and delete controls.

### Playing audio

Select the **Play** button next to any file to open a playback dialog with a standard audio player. This lets you verify the content and quality of each file without assigning it anywhere.

### Deleting audio files

Select the **Delete** button next to a file and confirm the deletion. The file is permanently removed from the library.

:::warning

Before deleting an audio file, verify that it's not currently in use by any menus, queues, or voicemail mailboxes. Removing an audio file that's referenced elsewhere may cause those configurations to fall back to default behavior or silence.

:::

## Related pages

-   [IVR menus](./ivr-menus-auto-attendant.md) -- use audio files for menu greetings
-   [Call queues](./call-queues.md) -- use audio files for queue greetings and hold music
-   [Voicemail](./voicemail.md) -- use audio files for voicemail greetings and followups
-   [Agent management](./agent-management.md) -- use audio files for unavailable greetings