> 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/publishing-and-distribution/publish-video-episodes-to-youtube.md).

# Publish video episodes to YouTube

Connect a YouTube channel for video uploads, or use the audiogram export for audio episodes.

Use this task to publish each new episode to a YouTube channel automatically. Podigee offers two YouTube uploads. In the classic view, they are on the **Exports** tab. In the Podigee workspace, they are the tabs **Video** and **Audio Visualization** of the **YouTube** page of **Reach**.

* **YouTube Video** in the **Video** section (classic view) or **Video** (Podigee workspace) uploads the video file of each episode to your channel. Use it when your episodes have a video file.
* **Youtube** in the **Audio** section (classic view) or **Audio Visualization** (Podigee workspace) uploads each episode as a video. Use it when your episodes are audio only.

Audio visualization selects the video source for each episode:

* When the episode has a video file and the plan of the podcast owner includes video podcasts, Podigee uploads that video file.
* Otherwise, Podigee uploads an audiogram. An audiogram is a video that Podigee generates from the cover image and the chapter images over the audio.

## Before you start

* You need the owner, admin, or editor role for the podcast, with permission to edit the podcast.
* You need a Google account that manages the YouTube channel.

Before Podigee can upload to YouTube, these conditions must also be true:

* The account of the podcast owner has a paid plan. The free Launch plan does not include YouTube exports.
* For **Video** (**YouTube Video** in the classic view), the plan of the podcast owner includes video podcasts, or it is an older plan that includes them. **Audio Visualization** (**Youtube** in the classic view) does not need video podcasts in the plan.
* The podcast is published and is not restricted to invited listeners.
* At least one episode is published.

While you prepare the first episode of a new show in the Podigee workspace, the YouTube setup works on every plan. You can sign in to Google there before these conditions are true. Podigee examines the plan when you send the episode. The **YouTube** page of **Reach** examines the plan before you can sign in.

{% tabs %}
{% tab title="Classic view" %}
The **Video** section shows when the plan includes video podcasts, or on an older plan, where the tile offers an upgrade.

### Enable video features once

The **Video** section renders only after the podcast owner or an organization administrator accepts the terms for video features.

1. Open the podcast and select the **Exports** tab.
2. In the banner **New: Video Podcasts!**, select **Enable video features**.
3. In the dialog **Enable Video Features**, select **I understand and want to continue.**
4. Select **Continue**.

Other members see **Video features need to be enabled first. Please ask your organization admin or podcast owner to enable them.**

### Connect YouTube Video

1. In the **Video** section, select the **YouTube Video** tile.
2. Select **Connect YouTube Account** and complete the Google sign-in in the popup window.
3. Under **Select YouTube channel**, select the channel.
4. Choose which existing episodes Podigee uploads: **No existing episodes, only new ones**, **Last 10 episodes**, or **All episodes**.
5. Choose the **Default privacy setting** for uploads: public, private, or unlisted. The default is unlisted.
6. Choose the **YouTube category**. The default is **People & Blogs**.
7. Select **Enable**.

The tile shows **Pending** while Podigee sets up the channel and then **Published**. From now on, Podigee uploads the video file of each episode when the episode goes live.

To upload one episode again, open the episode, and use the YouTube re-upload action on the media tab. Podigee confirms with **Your YouTube re-upload has been queued.** The action works only while the connection is enabled and the episode is publicly live.

If you switch to another channel later, Podigee starts a new mapping for the episodes.

### Connect the audiogram export

1. In the **Audio** section, select the **Youtube** tile.
2. Read the YouTube terms of service text.
3. Connect your Google account.
4. Enable **Post to Youtube when new a episode is published**.
5. Choose the privacy setting and the category. The privacy default is private.

The tile notes that YouTube by default allows uploads of up to 15 minutes and asks you to verify your YouTube account for longer episodes. After you verify the account at YouTube, confirm with **I verified my account**.

From now on, Podigee generates the audiogram after each audio encoding and uploads it. When the plan includes video podcasts and the episode has a video file, Podigee uploads the original video instead.

### Expected result

New episodes appear on your YouTube channel with the chosen privacy setting after they go live in Podigee.

### If you cannot complete the task

* The **Video** section is missing: the plan of the podcast owner does not include video podcasts, or the video features are not enabled yet.
* The tile shows **Please reconnect your Google Account to use the YouTube export.**: the Google authorization expired. Connect the account again.
* The podcast owner receives **The connection to YouTube has been disconnected**: YouTube refused further uploads for the day. Connect the account again later.
* **YouTube Video** shows **Action needed**: the connection failed. Open the tile to reconnect. The episode shows the upload errors of that episode, for example **Your episode does not have a video file.**, an unsupported format, or a thumbnail that is not 16:9.
* The episode page shows **YouTube is not connected for this podcast right now\...**: enable **YouTube Video** first.
  {% endtab %}

{% tab title="Podigee workspace" %}
In the Podigee workspace, you set up YouTube on the **YouTube** page of **Reach**. The **Setup** card of this page has two tabs:

* **Audio Visualization** uploads each new episode to YouTube as a video. The tab says: "Uploads use your video recording when available. Otherwise, Podigee creates a video from your audio and artwork." This is the **Youtube** export of the classic view.
* **Video** uploads the video file of each new video episode to the channel that you choose. This is the **YouTube Video** export of the classic view.

The two tabs use one Google sign-in. Each tab keeps its own upload settings. While video delivery is on, it replaces the automatic audio visualization uploads. The classic view and the Podigee workspace change the same YouTube connection of the show.

To change the YouTube setup, you need the permission to edit the show and to change where the show is published. Without these permissions, the page shows the state only. The plan of the show owner decides what the page offers, also when you are a team member.

### Open the YouTube page

1. Open the show.
2. In the sidebar, under **Publish**, select **Reach**. Reach opens on **Channels**.
3. On **Channels**, select the tab **All** or **Set up from here**.
4. Select the **YouTube** row.

The **YouTube** page opens. Each tab of the **Setup** card shows numbered steps. Each step shows a status: **Done**, **In progress**, **Waiting**, **Needs attention**, **To do**, or **Not yet**. Select a step to open it.

The page opens on the **Audio Visualization** tab. While video delivery is on or in progress, it opens on the **Video** tab. When a setup that you started needs you, the page opens on the tab of that setup.

Below the **Setup** card, the card **Your YouTube connection** shows the buttons **YouTube terms**, **Google privacy policy**, and **Manage Google access**.

#### States of the YouTube row

The **YouTube** row on **Channels** shows one pill for each version, for example **Audio Visualization · Connected** and **Video · Not set up**.

* The **Audio Visualization** pill shows **Not set up**, **Connected**, or **Reconnect needed**.
* The **Video** pill shows **Not set up**, **Choose your channel**, **In progress**, **Connected**, or **Needs attention**. **Choose your channel** means that the Google sign-in is done, but video delivery is not on.
* While video delivery is on or in progress, only the **Video** pill shows.
* While no version is set up, one pill such as **Paid plans** or **Unavailable** can show instead.
* A setup that started and waits for you shows **Needs attention**.

### Set up audio visualization

Before you start, make sure that the plan of the show owner includes automatic YouTube uploads.

The tab **Audio Visualization** has these steps: **Your plan includes audio visualization**, **Sign in with Google**, and **Set up automatic uploads**.

1. Select the tab **Audio Visualization**.
2. Examine the step **Your plan includes audio visualization**. It must show **Done**.
3. Open the step **Sign in with Google**.
4. Select **Connect Google account**. A popup window with the Google sign-in opens.
5. Sign in with the Google account that manages the YouTube channel.
6. Allow each permission that Google asks for. The page loads again.
7. Open the step **Set up automatic uploads**.
8. Under **Upload settings**, select **Upload new episodes automatically when they are published**.
9. Select the **Default visibility**: **Public**, **Unlisted**, or **Private**. The default is **Private**.
10. Select the **YouTube category**.
11. Select **Save settings**.

The page shows "YouTube upload settings saved." The **Setup** card shows "YouTube for audio visualization is set up." The **YouTube** row shows **Audio Visualization · Connected**. Podigee uploads each new episode when you publish it.

To stop the automatic audio visualization uploads, clear **Upload new episodes automatically when they are published**. Then select **Save settings**.

#### Uploads longer than 15 minutes

YouTube must verify your account before it accepts uploads longer than 15 minutes. The card **Uploads longer than 15 minutes** shows below the **Setup** card when these conditions are true:

* The tab **Audio Visualization** is open.
* A Google account is connected.
* Video delivery is not on.
* You did not select **I verified my account** before.

1. Select **Verify on YouTube**. The YouTube help opens in a new tab.
2. Verify your account on YouTube.
3. In Podigee, select **I verified my account**.

The card closes. Podigee does not examine the verification on YouTube.

### Set up video delivery

The choice **Earlier video episodes** is only in this procedure. Make this choice before you enable video delivery. After video delivery is on, you can send one older video episode from its YouTube page (see "Send one episode from its YouTube page").

The tab **Video** has no setting for content that is made for kids. When you enable video delivery on this tab, Podigee saves this setting as off for the show. This also applies to the earlier episodes that you select. Only the YouTube page of an episode has the setting **This video is made for kids**. If your show is made for kids, do the first send from the YouTube page of an episode.

Before you start, make sure of these conditions:

* The plan of the show owner includes video and distribution.
* The video features are enabled for the account (see "Enable video features" below).
* The show has a released episode. You can connect before you upload your first video recording.
* You have a Google account that manages the YouTube channel.

The tab **Video** has these steps: **Your account can use video**, **Your show has a released episode**, **Sign in with Google**, and **Set up YouTube video delivery**.

1. Select the tab **Video**.
2. Examine the step **Your account can use video**. It must show **Done**.
3. Examine the step **Your show has a released episode**. It must show **Done**.
4. Open the step **Sign in with Google**.
5. Select **Connect Google account**. When the show has a Google sign-in, select **Reconnect Google account**.
6. Sign in with the Google account that manages the YouTube channel.
7. Allow each permission that Google asks for. The page loads again.
8. Open the step **Set up YouTube video delivery**.
9. In **YouTube channel**, select the channel. When the account has one channel, Podigee selects it.
10. Under **Earlier video episodes**, select one option. The default is **Upload only new episodes**.
    * **Upload only new episodes**
    * **Also upload the last 10 published video episodes**
    * **Also upload all published video episodes**
11. Select the **Default visibility**. The default is **Unlisted**.
12. Select the **YouTube category**. The default is **People & Blogs**.
13. Select **Enable YouTube video delivery**. The dialog **Please confirm** opens.
14. Read the text: "Enable YouTube video delivery with these settings? Automatic audio visualization uploads will stop. Selected earlier episodes may be uploaded. Existing videos stay on YouTube."
15. Select **Enable YouTube video delivery**. To stop, select **Cancel**.

The page shows "YouTube video delivery is enabled." or "Setting up YouTube video delivery. You can follow its status here." While the setup runs, the step shows **In progress** and "Setting up YouTube video delivery...". The page checks the status while it is open. You can leave the page.

When the setup is done, the **Setup** card shows "YouTube for video is set up." The step shows "Channel: \[channel]" and "YouTube video delivery is enabled. New video episodes are uploaded automatically." The **YouTube** row shows **Video · Connected**. Podigee queues the earlier episodes that you selected and uploads them in the background. It skips episodes that have no video file. The automatic audio visualization uploads stop.

When the channel does not accept long uploads, the step shows "This channel does not have long uploads enabled. Verify it on YouTube before uploading episodes longer than 15 minutes." Select **Verify on YouTube**. Then verify the channel on YouTube.

#### Enable video features

Only the account owner or an organization administrator can do this procedure. It is the same acceptance as **Enable video features** in the classic view.

1. Select the tab **Video**.
2. Open the step **Your account can use video**.
3. Under **Enable video features**, read the Podigee Terms of Service.
4. Select **I accept the Podigee Terms of Service and want to enable video features.**
5. Select **Enable video features**.

The page shows "Video features are enabled. Continue with YouTube setup below." Other members see "Ask your account owner or organization admin to enable video features here."

![The YouTube page in the Podigee workspace with the Setup card on the Video tab: the open step Your account can use video with the box Enable video features, then the steps Your show has a released episode and Sign in with Google](https://2032417310-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FbqUKO6lljHGzkEAzliPI%2Fuploads%2Fgit-blob-11d83e836a28ca5cda6902099694bf3a563316a1%2Fdoc-distribution-008-youtube-page.png?alt=media)

On the Video tab, the first step enables the video features of the account.

### Change the upload settings

1. On the **YouTube** page, select the tab of the version that is set up.
2. Open the last step: **Set up automatic uploads** or **Set up YouTube video delivery**.
3. Under **Upload settings**, change the **Default visibility** or the **YouTube category**.
4. Select **Save settings**.

The page shows "YouTube upload settings saved." or "YouTube video upload settings saved." The new settings apply to future uploads. On the **Video** tab, the section says "These defaults apply to future uploads. Videos already on YouTube keep their settings."

To use another channel for video delivery, turn off video delivery first. Then set up video delivery again and select the other channel.

### Turn off video delivery

The actions of a tab show below its steps.

1. On the **YouTube** page, select the tab **Video**.
2. Select **Turn off video on YouTube**. The dialog **Please confirm** opens.
3. Read the text: "Stop uploading new video episodes? Videos already on YouTube stay there. An upload already running may finish. Google access stays connected."
4. Select **Turn off video on YouTube**. To keep video delivery, select **Cancel**.

The page shows "YouTube video delivery is off. Your videos stay on YouTube." The Google sign-in stays connected. The automatic audio visualization uploads do not start again. To use them, set up audio visualization again.

The tab **Video** also shows **Open in YouTube Studio** when Podigee knows the channel. This button opens the channel in YouTube Studio.

### Disconnect the Google account

This removes the connection to the Google account of the show in Podigee. Podigee deletes its stored sign-in. You manage the access of Podigee in your Google account itself. **Disconnect Google account** shows on both tabs only while video delivery is off.

1. If video delivery is on, turn it off first.
2. On the **YouTube** page, select **Disconnect Google account**. The dialog **Please confirm** opens.
3. Read the text: "Disconnect this show's Google account? Automatic uploads and YouTube analytics updates will stop. Videos already on YouTube stay there. You can connect again later."
4. Select **Disconnect Google account**. To keep the account, select **Cancel**.

The page shows "The YouTube account is disconnected. Podigee no longer uses its sign-in." The steps **Sign in with Google** show **To do** again.

* Videos stay on YouTube.
* Podigee keeps the channel and the list of the uploaded episodes. When you connect the same channel again, Podigee does not upload these episodes again.
* To examine or remove the access in your Google account, select **Manage Google access** in the card **Your YouTube connection**. The Google page opens.

### Send one episode from its YouTube page

Each episode has a YouTube page, **Send this episode to YouTube.** On this page, you send one video episode. When the show has no YouTube channel yet, you also select the channel for the show here. To send an episode, you also need the permission to publish episodes.

You can open the YouTube page of an episode in these ways:

* On the episode page, the section **Where is my episode?** shows a YouTube row. When the row shows **Not sent**, select **Send to YouTube**. This link shows when the episode is public and has a video file.
* After the first episode of a show goes live, the page **Your first episode is live.** shows **Where it's going**. In the YouTube row, select **Send to YouTube**. This link shows when the episode has a video file and the account can use video.
* Ask Podigee AI to send the episode to YouTube. When the show has no YouTube channel yet, Podigee AI gives you a link to the YouTube page.

1. Open the YouTube page of the episode.
2. If the page shows **Connect YouTube**, select it.
3. Sign in to Google in the popup window. The page loads again.
4. In the panel **Send this episode**, select the channel in **YouTube channel**.
5. Under **YouTube settings for this show**, select the **Privacy**. The default is **Unlisted**.
6. Select the **Category**. The default is **People & Blogs**.
7. If the episodes are made for kids, select **This video is made for kids**.
8. Select **Send this episode**.

![The panel Send this episode on the YouTube page of an episode in the Podigee workspace, with the YouTube channel, Privacy, and Category fields, the made for kids checkbox, and the Send this episode button](https://2032417310-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FbqUKO6lljHGzkEAzliPI%2Fuploads%2Fgit-blob-29e1c51f58d8cd6d5856c508ea2248ffd106fbc3%2Fdoc-distribution-008-youtube-setup.png?alt=media)

You choose the channel and the settings for the show once, on the YouTube page of an episode.

Above the button, the page says "Sending this episode also turns on automatic uploads to YouTube for new video episodes of this show." Podigee uploads this episode and the new video episodes after it. It does not upload older episodes. Each send queues only its own episode. To send an older video episode, open the YouTube page of that episode and select **Send this episode**. The episode must be public and must have a video file.

The settings of the first send apply to the show. This includes **This video is made for kids**. **Upload settings** on the **Video** tab can change only the visibility and the category.

When the show has a channel, the panel says "Sends to \[channel]." and "New video episodes of this show are uploaded to this channel automatically." It has no fields. To change the settings, see "Change the upload settings".

When video delivery is off and the episode is already on YouTube, the page says "Uploads to YouTube are off for this show." Select a channel. Then select **Send this episode**. This turns the uploads on again. When you select the same channel, Podigee does not upload this episode again.

### Set up YouTube for the first episode

While Podigee prepares the first episode of a new show, the section **Prepare destinations** shows a **YouTube** card.

1. On the **YouTube** card, read the state **Needs action** and the text "Set up your channel now. This will not publish anything."
2. Select **Set up YouTube**.
3. Sign in to Google in the popup window. The card shows **Connected** and "YouTube is connected. Channel details come before submission."
4. Complete the flow and publish the episode.
5. On the page **Your first episode is live.**, find the YouTube row under **Where it's going**.
6. If the row shows **Send to YouTube**, select it. Then continue with step 4 of "Send one episode from its YouTube page".

**Send to YouTube** shows only when the episode has a video file and the account can use video. When the row shows **View plans**, the plan of the show owner does not include publishing to YouTube. The Google sign-in stays saved. You can send a video episode after you change the plan.

To do the setup later, select **Connect later** on the card.

### Expected result

* After **Connect Google account**, the step **Sign in with Google** shows **Done**. Nothing is uploaded yet.
* After **Save settings** on the **Audio Visualization** tab, each new episode goes to YouTube as a video when you publish it.
* After **Enable YouTube video delivery**, each new video episode goes to YouTube when it goes live. Podigee also queues the earlier episodes that you selected.
* After **Send this episode**, the card **Publishing status** shows the YouTube state: **Sending**, then **Processing**, then **Live**. When the privacy is **Private**, the last state is **Private**. The list **Steps to YouTube** shows the progress. The page updates itself.
* When YouTube has the video file, the page shows **Open video**. This button can show while the state is still **Processing**.
* On the episode page, the section **Where is my episode?** shows the YouTube row, for example **On its way**, **Live**, or **Unlisted**.

### If you cannot complete the task

* A step has no button. Examine the step:
  * **Not yet**: an earlier step is not done. Do the earlier step first.
  * "Connect your Google account above to configure uploads.": do the step **Sign in with Google** first.
  * "Complete the account access step above before connecting Google.": the plan or the video features are missing. Examine the first step of the tab.
  * "Complete the steps above before enabling video delivery.": an earlier step of the tab **Video** is not done.
  * The page shows "You can see where this show is published. Setting up channels needs permission to edit this show.": ask a person who can edit the show.
* The step **Your plan includes audio visualization** shows "Your plan does not include automatic YouTube uploads. Choose a plan that includes YouTube to enable them.": select **Upgrade plan**. If you do not manage the plan, select **Ask the show owner** or **Ask \[owner]**.
* The step **Your account can use video** shows "Choose a plan that includes video and distribution to set up YouTube video delivery.": select **Upgrade plan**, or ask the show owner.
* The step **Your account can use video** shows "Ask your account owner or organization admin to enable video features here.": ask the account owner or an organization administrator to do "Enable video features".
* The step **Sign in with Google** shows **Needs attention** and "A permission is missing. Sign in with Google again and allow every permission.": select **Reconnect Google account**. Allow each permission.
* The **YouTube** row shows **Audio Visualization · Reconnect needed**: the Google sign-in stopped working. On the tab **Audio Visualization**, select **Reconnect Google account**.
* "Google sign-in did not finish. Please try again and allow the requested permissions.": the browser blocked the popup window, or the sign-in stopped. Allow popup windows for Podigee. Then select **Connect Google account** again.
* "Google sign-in was canceled. Your connection has not changed.": select **Connect Google account** again when you are ready.
* "This Google account has no accessible YouTube channel. Create a channel or connect a different account, then check again.": select **Create a YouTube channel**, and create the channel on YouTube. Then select **Check again**. Or select **Reconnect Google account** and use the Google account of the channel.
* "Your YouTube channels could not be loaded. Check again or reconnect your Google account.": select **Check again**. If the message stays, select **Reconnect Google account**.
* "Turn off YouTube video delivery before configuring audio visualization.": video delivery is on. To use audio visualization, select **Turn off video on YouTube** first.
* "YouTube video setup is already running. Wait for it to finish or turn it off below.": wait until the step shows **Done** or **Needs attention**.
* The step **Set up YouTube video delivery** shows **Needs attention** and **Why it stopped**: read the reason. Correct the Google sign-in or the channel. Then select **Enable YouTube video delivery** again.
* "YouTube setup is still unfinished after 30 minutes. Automatic checks have stopped. Check again or turn off video below.": select **Check again**. To start the setup again, select **Turn off video on YouTube** first.
* "The YouTube status could not be refreshed. Check again in a moment.": select **Check again**.
* **Disconnect Google account** is not on the page: video delivery is on. Select **Turn off video on YouTube** first. If the page shows "Turn off uploads before you disconnect the YouTube account.", do the same.
* **Send this episode** on the YouTube page of an episode is disabled: examine the list **YouTube readiness** (see below). If you do not have the permission to publish episodes, ask a person who has it.
* The YouTube page of an episode shows a plan notice: select **View plans**, or ask the account owner to change the plan.
* The YouTube page of an episode shows **We could not submit this episode to YouTube yet. Check the readiness items and try again.** with one of these messages:
  * "Choose a YouTube channel first."
  * "Connect YouTube first."
  * "Choose a visibility and a category from the list."
  * "The connected Google account cannot upload to this channel. Choose another channel or connect YouTube again."
  * "The YouTube channel of this show has changed. Reload the page and check the channel before you send."
  * "YouTube could not be reached. Try again in a few minutes."
  * "YouTube could not be set up for this show. Try again in a few minutes."
* The YouTube page of an episode shows "Sending this episode to YouTube failed.": correct the cause, then select **Send again**. The page names the cause, for example:
  * "The YouTube sign-in has expired or was removed. Connect YouTube again, then send the episode again.": select **Connect YouTube** or **Connect YouTube again**. Sign in, then select **Send again**.
  * "YouTube's daily upload limit for this channel is used up. Send the episode again tomorrow.": select **Send again** on the next day.
* An upload of a later episode failed: see [A platform connection was disconnected](https://docs.podigee.com/documentation/connect-and-administer/troubleshooting/a-platform-connection-was-disconnected.md).

#### The list YouTube readiness

The YouTube page of an episode shows the list **YouTube readiness**. Each item has a dot. A filled dot shows a condition that is true. An open dot shows a missing condition. **Send this episode** needs all of these conditions:

* **Episode is live**
* **YouTube account connected**
* **Video file available**
* **YouTube Video available**
  {% endtab %}
  {% endtabs %}

## Next step

[Post new episodes to Facebook](https://docs.podigee.com/documentation/create-and-publish/publishing-and-distribution/post-new-episodes-to-facebook.md)


---

# 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 by asking a question.

Perform an HTTP GET request on the following URL with the `ask` and `goal` query parameters:

```
GET https://docs.podigee.com/documentation/create-and-publish/publishing-and-distribution/publish-video-episodes-to-youtube.md?ask=<question>&goal=<user_goal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is what the user is ultimately trying to achieve, the reason they need the answer. Sharing it helps GitBook give you a better, more relevant answer. A goal is most helpful when it describes the outcome the user wants rather than restating the question. For example, with `ask=how do I create an API token`, a goal like `automate deployments from our CI pipeline` lets GitBook tailor the answer to that use case.

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.
