# Is there any size limit for llms.txt indexed as Docs?

**URL:** <https://forum.cursor.com/t/is-there-any-size-limit-for-llms-txt-indexed-as-docs/148660>\
**Category:** Help\
**Tags:** indexing, context\
**Created:** [January 12, 2026, 2:29pm UTC](https://forum.cursor.com/t/is-there-any-size-limit-for-llms-txt-indexed-as-docs/148660 "2026-01-12T14:29:06Z")\
**Posts on this page:** 4\
**Page:** 1

<div class="post-metadata">

**Author:** ![Joao\_Martins](https://avatars.discourse-cdn.com/v4/letter/j/f0a364/32.png) [@Joao\_Martins](https://forum.cursor.com/u/Joao_Martins)\
**Post date:** [January 12, 2026, 2:29pm UTC](https://forum.cursor.com/t/is-there-any-size-limit-for-llms-txt-indexed-as-docs/148660/1 "2026-01-12T14:29:07Z")

</div>

I’ve been using a 4MB llms.txt file indexed as Docs to provide full context for an API. The llms.txt file contains the docs for the dll of the API including all the properties, classes, methods…

Is this ok?

Any best practices for that?

Any limits for both free and paid tier?

---

<div class="post-metadata">

**Author:** ![deanrie](https://sea3.discourse-cdn.com/cursor1/user_avatar/forum.cursor.com/deanrie/32/1263_2.png) [@deanrie](https://forum.cursor.com/u/deanrie)\
**Post date:** [January 13, 2026, 11:53am UTC](https://forum.cursor.com/t/is-there-any-size-limit-for-llms-txt-indexed-as-docs/148660/3 "2026-01-13T11:53:02Z")

</div>

Hey, thanks for the request.

There aren’t any documented file size limits for @Docs in the official docs. But from community experience, files bigger than 50 to 60k tokens can be unstable during indexing.

Your 4 MB file, depending on what’s inside, is roughly 800k to 1.2M tokens (using ~5 characters per token). That’s a lot.

Based on this thread: [Tutorial: Adding full repo context, pdfs and other docs](https://forum.cursor.com/t/tutorial-adding-full-repo-context-pdfs-and-other-docs/33925), it’s recommended to split large files into multiple parts. This helps the system give the AI only the most relevant sections, which usually improves answer quality.

You can try:

- Split `llms.txt` into several logical files (by API sections, classes, etc.)
- Create a separate Gist for each part
- Add them as multiple @Docs with clear names

Is indexing working right now, or are you seeing issues? If it’s indexing successfully, you can keep it as-is, but splitting it usually gives better results in practice.

On free vs paid, the file size limits don’t depend on your plan. They’re technical indexing limits.

---

<div class="post-metadata">

**Author:** ![Joao\_Martins](https://avatars.discourse-cdn.com/v4/letter/j/f0a364/32.png) [@Joao\_Martins](https://forum.cursor.com/u/Joao_Martins)\
**Post date:** [January 13, 2026, 6:15pm UTC](https://forum.cursor.com/t/is-there-any-size-limit-for-llms-txt-indexed-as-docs/148660/4 "2026-01-13T18:15:41Z")

</div>

Thank you, Dean

I’ve tested the 4MB llms.txt and it has been working great (single file indexing). Now I got worried and curious, as it shouldn’t work, right 🤔 .  
Anyway, I’ll follow this guidance and find a way to split it or maybe add a search mechanism on top of that.

---

<div class="post-metadata">

**Author:** ![system](https://sea3.discourse-cdn.com/cursor1/user_avatar/forum.cursor.com/system/32/99069_2.png) [@system](https://forum.cursor.com/u/system)\
**Post date:** [April 13, 2026, 6:16pm UTC](https://forum.cursor.com/t/is-there-any-size-limit-for-llms-txt-indexed-as-docs/148660/5 "2026-04-13T18:16:14Z")

</div>

This topic was automatically closed 90 days after the last reply. New replies are no longer allowed.