> For the complete documentation index, see [llms.txt](https://everyday-digital.gitbook.io/authoring-docs/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://everyday-digital.gitbook.io/authoring-docs/content-pages/content-page-library/audio-+-text.md).

# Audio + Text

<figure><img src="/files/brido3YFOobtXpo4ntVr" alt=""><figcaption></figcaption></figure>

## What is an Audio + Text page?

**The Audio + Text page accommodates a .mp3 audio files and related text.** The page is perfect for short audio clips or podcast extracts.

## Quick steps: how to create & edit an Audio + Text page

1. **Open Authoring.** Create or open a [Learning Story](/authoring-docs/authoring/content-types/learning-story.md), [Assessment](/authoring-docs/authoring/content-types/assessment.md) or [Survey](/authoring-docs/authoring/content-types/survey.md) [content type](/authoring-docs/authoring/content-types.md).
2. **Open the Editor.**
3. **Add an Audio + Text page.** Select the + icon and choose Audio + Text from the Add Page options.&#x20;
4. **Edit the Audio + Text page.** Select the page to view the [Page Options](/authoring-docs/content-pages/story-and-page-settings.md#what-are-the-page-options), and select Update to add and edit content. Upload a .mp3 audio file (no larger than 5MB), add an image, and enter your text.\
   The image must be at least 1136 x 758px in size (.jpg or .png format).
5. **Format text layout and style.** Use the toolbar for basic text [formatting](#text-formatting-tools), and toggle to [Advanced Settings](#audio-+-text-advanced-settings) for further layout options.

## Audio + Text Advanced Settings

**Background Colour**\
Select an alternative background colour to override the theme default.

**Image Size**\
Large (default), Medium, Small

**Autoplay Audio**\
By default, audio is auto-played as soon as the user opens the page. If you do not choose to autoplay, a play button will be added.

**When the audio ends...**\
Decide what happens at the end of the audio clip: Play again (default), Stop, Go to next page.

**Image Effect (Non-Mobile)**\
Choose a image effect for the desktop/tablet version of your story. Effects include adding a white frame and/or a dark shadow.

**Image Tilt (Non-Mobile)**\
Tilt your image left or right.

## Audio + Text Tips and FAQs

### What format and size should the audio file be?

Audio files must be in .mp3 format and no larger than 5MB.&#x20;

### How many audio files can I add to a story?

**In stories, use audio files sparingly to avoid lagging.** Use Streams if your content is audio-rich.

### Why does my audio not autoplay?

**First pages do not autoplay.** If you choose to Autoplay the audio, a play icon will still show if it is the first page in your story. This is due to browser policies that prevent autoplay.

### How to format an Audio + Text page&#x20;

**Text formatting.** Refer to text formatting toolbar options in the [Text page](/authoring-docs/content-pages/content-page-library/text.md).

**Image formatting.** Refer to the [Advanced Settings](#audio-+-text-advanced-settings).


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter:

```
GET https://everyday-digital.gitbook.io/authoring-docs/content-pages/content-page-library/audio-+-text.md?ask=<question>&goal=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.