AI Resources¶
Polkadot provides files to make documentation content available in a structure optimized for use with large language models (LLMs) and AI tools. These resources help build AI assistants, power code search, or enable custom tooling trained on Polkadot's documentation.
How to Use These Files¶
- Quick navigation: Use
llms.txtto give models a high-level map of the site. - Lightweight context: Use
site-index.jsonfor smaller context windows or when you only need targeted retrieval. - Full content: Use
llms-full.jsonlfor large-context models or preparing data for RAG pipelines. - Focused bundles: Use category files (e.g.,
basics.md,reference.md) to limit content to a specific theme or task for more focused responses.
These AI-ready files do not include any persona or system prompts. They are purely informational and can be used without conflicting with your existing agent or tool prompting.
Access LLM Files¶
| Category | Description | File | Actions |
|---|---|---|---|
| Index | Markdown URL index for documentation pages, links to essential repos, and additional resources in the llms.txt standard format. | llms.txt | |
| Site index (JSON) | Lightweight site index of JSON objects (one per page) with metadata and content previews. | site-index.json | |
| Full site contents (JSONL) | Full content of documentation site enhanced with metadata. | llms-full.jsonl | |
| Basics | A Polkadot general knowledge base that provides context around overview and beginner-level content. | basics.md | |
| Smart Contracts | How to develop and deploy Solidity smart contracts on Polkadot Hub. | smart-contracts.md | |
| Chain Interactions | How to query on-chain data, send transactions, communicate across chains, and manage tokens and accounts on Polkadot-based chains. | chain-interactions.md | |
| Parachains | How to guides related to building, customizing, deploying, and maintaining a parachain. | parachains.md | |
| dApps | Information and tutorials for application developers. | dapps.md | |
| Networks | Information about Polkadot networks. | networks.md | |
| Polkadot Protocol | In-depth details about the Polkadot Protocol. | polkadot-protocol.md | |
| Infrastructure | Guide to node infrastructure. | infrastructure.md | |
| Tooling | Developer tooling resources. | tooling.md | |
| Reference | Reference material including key functions and glossary. | reference.md |
Note
The llms-full.jsonl file may exceed the input limits of some language models due to its size. If you encounter limitations, consider using the smaller site-index.json or category bundle files instead.
Last update: February 27, 2026
| Created: August 15, 2025
| Created: August 15, 2025