---
title: Documentation for AI agents
slug: resources
createdAt: 2026-10-27T16:07:00.341Z
---

Optimizely publishes its documentation in formats built for large language models (LLMs) and AI agents. These formats sit alongside the standard web pages at [docs.optimizely.com](https://www.docs.optimizely.com). They give an AI tool a cleaner, more compact view of the content than HTML, which uses fewer tokens and parses more reliably.

You can work with the documentation in two ways:

- **The** `llms.txt` **index** – A single file that lists every documentation page, for tools that discover content from a URL.
- **Markdown pages** – The plain-text version of any page, ready to read or paste into a prompt.

You do not need an Optimizely account or any setup. Any AI tool that can read a URL can use these formats.

## The `llms.txt` index

The `llms.txt` file is a plain-text index of the documentation, following the [llms.txt convention](https://llmstxt.org/). It lists every page, grouped by product area, and each entry links to the Markdown version of that page.

Find the index at the root of the documentation site:

:::BlockQuote
https\://docs.optimizely.com/llms.txt
:::

Use the index when you want an AI tool to find relevant pages before it reads them. Point the tool at the URL, or paste the URL into a prompt. The tool reads the index, identifies the pages that match your question, and then fetches only those pages.

The index covers every Optimizely product, so the file is large. Use it to locate the pages you need, then load only those individual pages into the tool rather than the whole index.

## Markdown versions of pages

Every documentation page has a Markdown version. The Markdown holds the page content without the site navigation, scripts, or styling. This uses fewer tokens than HTML and reduces the chance that a tool misreads the page.

To get the Markdown version of a page, add `.md` to the end of its URL. For example, the Explorations page in Analytics has these two addresses:

- **Web version** – `https://docs.optimizely.com/analytics/docs/explorations`
- **Markdown version** – `https://docs.optimizely.com/analytics/docs/explorations.md`

This works for any page on the site. Give an AI tool the .md address when you want it to read a single page accurately with the least overhead.

## Choose the right format

Use the format that fits the size of the task:

- **One page** – Add `.md` to the page URL and give that address to your tool.
- **A set of pages on a topic** – Point your tool at `https://docs.optimizely.com/llms.txt` so it can find the relevant pages, then read the Markdown version of each one.
- **The documentation for a whole product** – Start from the index, filter to the product area, and read the Markdown pages your task needs.

## Example prompts

Give an AI tool that can read a URL a prompt like one of these.

To find pages on a topic:

:::BlockQuote
Read https\://docs.optimizely.com/llms.txt and list the pages about Feature Experimentation.
:::

To answer a question from a single page:

:::BlockQuote
Read https\://docs.optimizely.com/analytics/docs/explorations.md and explain the difference between a Report template and an Ad hoc analysis template.
:::