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

# Upload audio

BeyondWords lets you upload your own audio files for storage and distribution. This means you can manage and distribute other types of audio content (such as human-narrated podcasts) alongside your [AI-generated audio](/docs-and-guides/content/audio).

<Tip>
  To insert an audio or video clip into a specific content item, use the Editor. You can upload an audio intro and outro through player settings.
</Tip>

## Create a new content item

<Steps>
  <Step title="Start a new upload">
    Go to your project dashboard and click **+ New → Audio upload**.
  </Step>

  <Step title="Add your file">
    Drag and drop your audio file, or click **Upload audio** to select it.

    Files must be in MP3 or WAV format and up to 50MB.
  </Step>

  <Step title="Name your audio">
    Give your audio a title and description.
  </Step>

  <Step title="Add details in the sidebar (optional)">
    In the sidebar, complete the following details:

    * **Audio visibility**: Set visibility to public or private. You can also set a specific publish date and time, if required.
    * **Author**: The author to associate with this audio. This metadata can be used when creating playlists and podcast feeds.
    * **Feature image**: This can appear in the preview for the shareable URL.
    * **ID**: Automatically assigned by BeyondWords once the audio upload is complete.
    * **Source ID:** Add an ID from your system to link this audio to its source.
    * **Source URL**: Add the original content URL to link this audio back to its source.
    * **Properties**: Enable this to add custom metadata as JSON. This can be used to organize your content and power playlists and podcast feeds (e.g. `{"category": "sport"}`).
    * **Play ads**: Use the toggle to enable or disable ads on this audio. Ads will only play if you also enable direct ads or programmatic ads at the project level.
  </Step>

  <Step title="Upload audio">
    Click **Generate** to finish.
  </Step>
</Steps>

## Replace an existing content item

To replace an existing [content item](/docs-and-guides/content/content-items) with an audio upload:

1. Go to **Content → Items** in your project dashboard
2. Click **••• → Replace** alongside the content item you want to replace
3. Add your file and details as described above
4. Click **Regenerate** to finish

To replace audio in bulk or automate the workflow, see [Replace audio](/api-reference/content/replace-audio) in the API reference.

<Warning>
  Replacing a content item will permanently remove any existing generated audio and video associated with that item. After replacement, only the uploaded audio file will remain.
</Warning>

## FAQs

<AccordionGroup>
  <Accordion title="How can I distribute uploaded audio?">
    You can distribute uploaded audio in the same ways you distribute generated audio. For example, through [players](/docs-and-guides/distribution/player/player-introduction), [playlists](/docs-and-guides/distribution/playlists), [podcast feeds](/docs-and-guides/distribution/podcast-feeds), [downloads](/docs-and-guides/distribution/download), and [shareable URLs](/docs-and-guides/distribution/share-via-url).
  </Accordion>

  <Accordion title="Can I upload audio files in bulk?">
    No, you can't upload audio files in bulk through the BeyondWords dashboard. However, you can upload audio files in bulk using [Create and generate content](/api-reference/content/create) with `type: audio_upload`.
  </Accordion>

  <Accordion title="Can I edit uploaded audio?">
    You can edit the metadata associated with uploaded audio, but you can't edit the audio file itself. To edit the audio metadata:

    1. Go to **Content → Items** in your [project dashboard](/docs-and-guides/get-started/projects)
    2. Click your uploaded audio to open the Editor
    3. Change your metadata as desired
    4. Once complete, click **Regenerate**
  </Accordion>

  <Accordion title="Can I replace uploaded audio?">
    Yes, you can replace an uploaded audio file with a new version:

    1. Go to **Content → Items** in your [project dashboard](/docs-and-guides/get-started/projects)
    2. Click the **•••** icon alongside your audio
    3. Click **Replace**
    4. Delete the old audio file and upload a new one
    5. Update metadata as necessary, then click **Regenerate**
  </Accordion>

  <Accordion title="Why isn't my audio uploading?">
    If your audio isn't uploading, it may be because:

    * The file isn’t in MP3 or WAV format
    * The file is over 50MB
    * You haven't added a title
    * The upload was interrupted (e.g. due to a network issue)
    * The file is corrupted or unsupported

    If you need help, please [contact support](/docs-and-guides/support/get-support).
  </Accordion>
</AccordionGroup>