Audio and Text

This template is designed to display and play audio files alongside:
A title
A paragraph of text
An optional text transcript
Standard audio and volume controls
Like with image templates, this page includes several fields that must be completed to build your audio page. You can also live preview and publish the page from this screen.
Note: Pages must be published to appear within an article in the app.



Audio and Text Template Configuration
To create a new Audio and Text page, complete the following six sections:

1. Page Info (optional)
Used for internal reference only
Helps identify and organize pages in the Views panel of Contentful
Does not appear in the app
Highly recommended for keeping content organized
Add a descriptive title for easier navigation
Character limit: 256 characters

2. Title (required)
Displays as the main title of the page
Character limit: 40 characters

3. Subtitle (optional)
Optional field for supporting text under the main title
Character limit: 64 characters

4. Body (optional)
A rich text field where you can add paragraph content
Supports basic formatting (bold, italics, bullets, etc.)
Character limit: 900 characters

5. Audio (required)
This is where you import your audio source file
Supported formats: MP3 and WAV
See detailed steps below for adding audio files
6. Poster Image (optional)
Optional image that appears in the media player when this page is viewed
If no image is used, a default image will be applied
Supported formats: JPG and PNG
Follow the standard image upload steps
See Importing Images here for detailed instructions
Steps to Add an Audio File
Audio files—like videos, PDFs, and images—are nested within three layers of templates.
First, the audio file must be imported into a File Asset Template.
The File Asset Template is placed inside an Audio Asset Template.
The Audio Asset Template is then nested inside the Audio and Text Page Template.
Step 1: Add Media
Scroll to the Audio field and click Add media. You’ll see two options:
Select Existing Media
Choose an audio file that already exists in Contentful
It will be inserted automatically—no additional setup needed

Select Existing Media
Choose an audio file that already exists in Contentful
It will be inserted automatically—no additional setup needed

Upload New Audio Asset
Select a file from your desktop or local folder
New audio files must first be added to an Audio Asset Template

Step 2: Complete the Audio Asset Template
Once inside the Audio Asset Template, complete the required fields (see details below).
You can also live preview and publish from this screen.
Note: Audio assets must be published to appear in the app.
Step 3: Publish the Audio Asset
Click the green Publish button in the upper-right corner to publish your new audio file.
Reminder: If any required fields are missing, Contentful will display an error message.
Audio Asset Template Fields
To create a new Audio Asset template, complete the following sections:

Audio Info (Required)
Used for internal reference only
Does not appear in the app
Also acts as the title of the asset within its parent container
Character limit: 256 characters

Transcript (Optional)
Used to display transcript text for the audio file for accessibility display
A rich text field where you can copy and paste content
Supports basic formatting (bold, italics, bullets, etc.)
Optional

Credit (Optional)
You may enter a credit for the audio file (optional).
Maximum length: 200 characters
Optional

Audio (Required)
This is where you upload a new audio file or use one that’s already in Contentful.
To upload a new audio file:
Use the file selector to choose a file from your device
The new audio file must be embedded inside an Audio File Template, which is then nested in the Audio Asset Template
Think of the Audio Asset Template like the Focal Point Image Template—one lives inside the other, and both act as containers for specific media types.
Audio File Template Fields
To create a new Audio File template, complete the following sections:

Audio File Template Fields
Inside the Audio File Template, complete the following fields:
Title (optional)
Description (optional)
File (required)
Once the file is uploaded and processed:
The file preview will display in the window
The file name becomes the title of the asset container
Use the file selector (same process as with images) to choose a video file to import
See Importing Images for detailed steps.
Note: Don’t forget to publish your Audio File Template to make it available to all parent containers. If required fields are missing, Contentful will display an error message.
Last updated