Skip to content

Sounds & albums

The Sounds tab is a library of ambient audio grouped into albums. An album is a themed collection (e.g. "Ocean", "Rain"); each album contains tracks (the individual playable sounds).

There are two content types here — sound albums (the parent grouping) and sounds (the tracks). Both follow the universal authoring model.

Sounds tab with albums

Albums

Parent fields

Field What it means
Slug Stable id, e.g. ocean. Permanent once published. Coach cards and deep links reference an album by this slug.
Display order Where the album sits in the Sounds list (1 = first).
Banner image The album artwork (an image asset).

Translation fields

Field What it means
Title The album name.
Description A short blurb shown on the album.

Tracks (sounds)

Each track belongs to one album.

Parent fields

Field What it means
Slug Stable id for the track, e.g. ocean-gentle-waves.
Album The album this track belongs to.
Tier free or premium. A premium track is gated behind the subscription. Aim for at least one free track per album so the album isn't entirely locked.
Unlocks in week 1, 2, or 3 — the program week at which this track becomes available. Use this to pace the library so it opens up over the program rather than all at once.
Audio The track's audio file (an audio asset).
Duration Filled from the audio file length.

Translation fields

Field What it means
Title The track name.

Advanced/auto fields. Tracks also carry a default mixing point and an optional spatial-audio configuration. These are for the audio/mixing pipeline and are not part of normal editorial authoring — leave them at their defaults unless an engineer asks otherwise.

How a track is referenced elsewhere

  • A Coach sound card can point at a whole album (by its slug) or at a single track. Album references use the album slug; single-track references use the track's internal id (the app resolves it). See Coach Conversations for how sound cards are authored.
  • A teaser_card can also link to /sounds/album/<album-slug> as a navigation target.

What blocks a save / publish

  • An audio file (track) or banner image (album) that doesn't resolve blocks publishing.
  • Renaming an album or track slug while a translation is published.
  • An album with no published tracks won't render usefully — make sure tracks are published alongside the album.

Where it shows up

The Sounds tab: albums in display_order, each expanding to its published tracks. Premium tracks show a lock until the user subscribes; tracks above the user's current program week stay locked until that week unlocks.

See also