> For the complete documentation index, see [llms.txt](https://docs.podigee.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.podigee.com/documentation/create-and-publish/production/episodes/add-chapter-marks.md). # Add chapter marks Add, edit, import, and remove chapter marks, and meet the requirements of directories. Use this task to structure an episode with chapter marks. Podigee writes the chapter marks into the audio files and shows them in players, in the feed, and on the podcast website. ## Before you start * You are the podcast owner, or you have permission to create and edit episodes in the podcast. * The episode has an uploaded media file, because each start time must be inside the audio duration. * The episode does not use ad insertion by an external ad provider. In that case the tab shows "Adding chapter marks to the episode is not possible." Before you add chapter marks, disable ad insertion for this episode, or change its ad provider. {% tabs %} {% tab title="Classic view" %} ### Add chapter marks one by one 1. Open the episode and select the **Chapter marks** tab. 2. Select **Add chapter mark**. Podigee adds a row named "Chapter N". The row starts at the time of the last chapter mark, or at 00:00:00 for the first chapter. 3. Enter the **Start time** as `hh:mm:ss` or `hh:mm:ss.mmm`. 4. Enter the **Title** (up to 255 characters). 5. Optional: enter a **Link** (a full URL) and select **Upload image** to add a chapter image. 6. Save the row. Repeat for each chapter. Podigee sorts the chapter marks by start time after every change. ![Chapter marks tab of an episode in the classic view with the Add chapter mark button, the Upload chapters from file control, and the AI Chapter marks section](https://2032417310-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FbqUKO6lljHGzkEAzliPI%2Fuploads%2Fgit-blob-294abb27075ba517f1c210137db45ec32b40a3d0%2Fdoc-production-008-classic-chapter-marks-tab.png?alt=media) The Chapter marks tab offers manual entry, a file upload, and AI chapter marks after the audio is processed. ### Import chapter marks from a text file 1. Prepare a plain text file with the `.txt` extension. Put one chapter mark on each line: ``` 00:00:00 Welcome 00:01:30 Intro 00:12:45 Interview ``` The start time comes first, then the title. A link is optional. Put the link in angle brackets at the end of the line. Podigee skips empty lines. 2. On the **Chapter marks** tab, open **Upload chapters from file** and use **Select a file**. 3. Confirm the upload. Podigee creates all chapter marks of the file in one step. Existing chapter marks stay in place. To replace them, select **Delete all** first. ### Use chapter marks from the audio file When you upload a single audio file from your computer, Podigee imports the chapter marks and the cover image that the file contains. The tab shows "We are importing existing chapter marks from your episode's metadata. Please wait until this process is complete." while the import runs. Select **Refresh** to reload the table. ### Expected result * The table lists the chapter marks with **Start time**, **Title**, **Link**, **Image**, and **Actions**. Podigee shows "Successfully created" or "Successfully saved". * For an encoded episode, Podigee writes the chapter marks into the audio files in the background. You do not need to update the audio file. * The **Chapter marks** tab shows the requirements of some podcast directories: "Minimum of 3 chapter marks", "A chapter mark with timestamp 00:00:00 must be present", and "Chapters should be at least 10s apart". When you want the chapters to appear in those directories, meet these requirements. ### If you cannot complete the task * "must be within the episode.": the start time is later than the audio duration. * "Text file with a .txt extension should be provided.": save the file as plain text with the `.txt` extension. * "We couldn't find valid chapter mark data in the provided file.": check that each line starts with a time in the `hh:mm:ss` format. * "Upload failed: The chapter marks file contains invalid UTF-8 characters ...": save the file with UTF-8 encoding and upload it again. * The tab is missing: you do not have permission to edit episodes in this podcast. An AI agent can also replace chapter marks. See the agent page [Replace chapter marks safely](/documentation/start-here/ai-agents/manage-episodes/replace-chapter-marks-keywords-or-transcript-data-safely.md). {% endtab %} {% tab title="Podigee workspace" %} In the Podigee workspace the chapters are a section of the episode editor. 1. Open the podcast and select **Episodes**. Open the episode. 2. Select **Edit details** and go to **Chapter markers**. 3. Select **Add chapter**. Enter the **Start time** and the **Chapter title**. The hint reads "Use MM:SS for shorter episodes or HH:MM:SS when needed." 4. Optional: select **Generate with Podigee AI** to get suggested chapters. Review the timestamps before you save them. 5. Select **Remove chapter** on a row that you do not need. 6. Select **Save changes**. What is different: * Podigee saves the chapters with the whole episode form, not row by row. * A chapter has a start time and a title only. There is no **Link** and no **Upload image**. * There is no **Upload chapters from file** and no **Delete all**. * The **Visibility check** of the episode preview shows **Chapters set** when chapters exist. {% endtab %} {% endtabs %} ## Next step [Create and edit transcripts](/documentation/create-and-publish/production/episodes/create-and-edit-transcripts.md) to add the episode as text. --- # 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://docs.podigee.com/documentation/create-and-publish/production/episodes/add-chapter-marks.md?ask=&goal= ``` `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.