> ## Documentation Index
> Fetch the complete documentation index at: https://docs.agentcdn.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Choose where your videos appear

> Turn on AgentTV watch pages, AI apps and search engine indexing, and connect your own website.

Discovery is one page in the console: **Discovery**, under **Reach**. It decides where your public videos can appear. Open it at `https://app.agentcdn.com/discovery`.

The page has three cards:

1. **Where your public videos appear**: three switches and the list of included videos.
2. **What we publish**: what search engines and AI tools get, with a status and a copy button for each address.
3. **Your website**: connect your own domain, add the head tags, and set up WordPress.

## The three switches

| Switch in the console | API value | What it does |
| - | - | - |
| **AgentTV pages and search** | `pages` | Your public videos get public watch pages and show in AgentTV search. |
| **AgentTV apps in ChatGPT and Claude** | `apps` | Your public videos can answer in AI apps through the AgentTV apps. |
| **Google and Bing** | `search_engines` | Search engines can index your watch pages. They decide what to show. |

**AgentTV pages and search** is the base switch. While it is off:

* The other two switches have no effect. The console shows them disabled with "Turn on AgentTV pages and search first." Their saved values stay.
* Your watch pages, your library page, your Ask page and your public video address for AI apps are offline.

> [!WARNING]
>
> Turning off **AgentTV pages and search** takes your watch pages offline and removes your videos from AgentTV search. The AgentTV apps and Google and Bing stop too. The console asks you to confirm.

Turning off **AgentTV apps** also asks you to confirm. AI apps stop answering from your videos through the AgentTV apps. Your pages stay up.

### Which videos are included

Under the switches, the card says how many videos are included, for example "12 of 14 videos are included." Open **Why videos are left out** to see each left-out video and the fix:

| Reason shown | Fix |
| - | - |
| AgentTV pages and search are off. | Turn them on. |
| It is private on YouTube. / It is unlisted on YouTube. | Only public YouTube videos appear here. Make it public on YouTube. |
| The import is not finished. | It joins by itself when processing ends. |
| You left this video out. | Choose **Include**. |
| It is in a members-only library. | Move it in **Videos**. |
| Its rights settings do not allow search and citation. | Change it in **Agent access**. |
| The video page needs a title, thumbnail, and description. | Edit it in **Videos**. |

To leave one video out, set it to unlisted in **Videos**. Its link keeps working, but it leaves your public pages, search and the apps. **Include** sets it back to public.

### Change the switches from code

Read the switches, the counts and the left-out videos:

```bash theme={null}
curl "https://api.agentcdn.com/v1/discovery?show=left_out" \
  -H "Authorization: Bearer $AGENTCDN_API_KEY"
```

`show` is `left_out` (default) or `all`. Page with `offset` and `limit` (up to 200).

Change one switch with `POST /v1/discovery`:

```json theme={null}
{ "control": "search_engines", "enabled": true }
```

This is a change, so it runs in two calls: a preview, then the same request with `confirm_token`. See [Changes run in two calls](https://docs.agentcdn.com/api-keys.md#changes-run-in-two-calls).

* `apps` and `search_engines` return `409 pages_off` while `pages` is off.
* Asking for the value a switch already has returns `409 no_change`.

On the [account MCP](https://docs.agentcdn.com/guides/connect-mcp.md#account-mcp), the same operations are the `get_discovery` and `set_discovery` tools.

## What we publish

With **AgentTV pages and search** on, AgentTV hosts a public page for your library and one watch page for each included video:

* Library page: `https://agenttv.com/creators/your-brand`
* Watch page: `https://agenttv.com/creators/your-brand/videos/vid_123/watch`

The **What we publish** card lists what search engines and AI tools get on top of those pages. Each row shows **Live**, **Waiting**, **Off** or **Not available right now**.

**Search engines**

| Row | What it is |
| - | - |
| **Video sitemap** | A list of your watch pages for search engines: `https://api.agentcdn.com/public/creators/your-brand/sitemap.xml`. Live only when **Google and Bing** is on. |
| **Video markup** | Tells search engines the title, length and thumbnail of each video. |
| **Public transcripts** | Readable text on each watch page. The badge counts public videos with a public transcript. |
| **Page updates** | AgentTV tells search engines when your pages change. |

**AI formats**

| Row | What it is |
| - | - |
| **Agent-Ready Video (ARV)** | The open format AI apps read to find and play your videos. |
| **llms.txt** | A short index of your videos for AI tools: `https://api.agentcdn.com/public/creators/your-brand/llms.txt`. |
| **NLWeb** | Lets compatible AI apps ask your catalog questions. |
| **WebMCP** | Lets browser AI apps use your site's video tools. |

Copy each address with the button on its row. To connect an AI app to your videos, choose **Connect an assistant**. It opens [AI assistants](https://docs.agentcdn.com/guides/your-ai-app.md#connect-claude-and-other-ai-apps).

## Your website

This card connects your own website to AgentTV. It has three tabs.

| Tab | What you do there |
| - | - |
| **Domain** | Enter your website domain, such as example.com. Choose a video address on it. AgentTV gives you a DNS record to add. Full guide: [Serve agents from your domain](https://docs.agentcdn.com/guides/branded-agent-host.md). |
| **Install** | 1. Add the head tags to every page. 2. Optional: add the agent readiness kit, files that help AI agents find your video tools. 3. **Verify**. |
| **Google** | Shows the Google Search checks for your domain. This tab appears once a domain is connected. |

The head tags must be in the HTML your server sends. Tags that a script adds in the browser do not count. Until your own address is live, the tags use AgentTV addresses.

### Add Ask to your website

The Ask box setup starts from the **Ask page** in the console. A link to `/discovery?setup=ask_embed_setup` sends you there. See [Add Ask to your site](https://docs.agentcdn.com/guides/embed-ask.md).

### WordPress

The WordPress setup adds current AgentTV video metadata to one existing WordPress page. Your page and your player stay as they are. The plugin adds a video record (`VideoObject`) and a breadcrumb when the page has none. It can update an existing video record only when it matches the same video exactly. Other SEO data on the page stays.

Open it at `https://app.agentcdn.com/discovery?setup=wordpress_setup`, or in **Your website**, **Install**, **WordPress**.

**Before you start:**

* **Google and Bing** is on.
* Your website is connected and verified, its install check passed, and you chose **Add video details to my existing pages** on the **Domain** tab.
* The video is a public YouTube video in your main public library. Videos in members-only collections cannot connect.
* The page is a public HTTPS permalink with one YouTube privacy-enhanced player (`youtube-nocookie.com`) in a **Custom HTML** block.

**1. Prepare the page connection**

Choose your **Verified website**, the **Public YouTube video**, and the **Existing page URL**. Confirm that the video is the page's main content and that you can exclude the page from full-page caches. Choose **Prepare page connection**.

**2. Install the plugin**

Download **AgentTV Metadata** from the panel. In WordPress, go to **Plugins, Add Plugin, Upload Plugin** and install the ZIP. The panel shows the package's SHA-256 if you want to check the download.

**3. Paste the configuration**

Copy the configuration from the panel. In WordPress, open **Settings, AgentTV Metadata**, paste it, confirm the cache exclusion, enable the page and save. The configuration holds no password or key.

**4. Check the page**

Back in the console, choose **Check installed page**. The setup check has a time limit. If it expires, choose **Create new setup configuration** and paste the new one.

**5. Activate**

After the page check passes, AgentTV reviews playback. Choose **Refresh review status**. When the review is complete, choose **Activate reviewed page**.

Until the page is active, normal visitors see your original page. Only AgentTV's check request sees the new metadata.

If the setup does not fit your site, choose **Request WordPress setup help** in the same panel.

## Related

* [Library Memory](https://docs.agentcdn.com/concepts/library-memory.md): the cited pages AI apps read about your library.
* [Publish your own app in ChatGPT](https://docs.agentcdn.com/guides/your-ai-app.md).
* [Add Ask to your site](https://docs.agentcdn.com/guides/embed-ask.md).
* [Serve agents from your domain](https://docs.agentcdn.com/guides/branded-agent-host.md).


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.