Custom doc indexed in Settings but not listed in @Docs chat dropdown

[dylanyz (Dylan G)]

Where does the bug appear (feature/product)?

Cursor IDE

Describe the Bug

When I add a custom documentation source in Cursor Settings, Indexing and Docs and it indexes successfully, the doc does NOT appear in the @Docs dropdown in chat. I only see built-in options (e.g. Unreal Engine Official) and “+ Add new doc”; my custom doc is missing even though it shows as Indexed with a date in Settings. The only way I can use that doc in chat is to use @Docs, “+ Add new doc”, and paste the same link again each time I want to reference it; it does not re-index (it lets me use the already-indexed doc), but I have to repeat this in every chat where I need it.

Steps to Reproduce

1. Open Cursor Settings, Indexing and Docs.
2. Click Add Doc and add a documentation URL (e.g. Documentation | GameDev Core by BlueprintsLab).
3. Wait for indexing to complete (doc shows Indexed with timestamp).
4. Open a new chat and type @Docs in the input.
5. Observe the dropdown: the custom doc does not appear; only default docs and “+ Add new doc” are shown.

Expected Behavior

The custom doc should appear in the @Docs dropdown so I can select it as context when using chat.

Screenshots / Screen Recordings

Operating System

Windows 10/11
MacOS

Version Information

MAC:

Version: 2.6.18
VSCode Version: 1.105.1
Commit: 68fbec5aed9da587d1c6a64172792f505bafa250
Date: 2026-03-10T02:01:17.430Z (1 day ago)
Build Type: Stable
Release Track: Default
Electron: 39.6.0
Chromium: 142.0.7444.265
Node.js: 22.22.0
V8: 14.2.231.22-electron.0
OS: Darwin arm64 24.6.0

WINDOWS:
Version: 2.6.18 (user setup)
VSCode Version: 1.105.1
Commit: 68fbec5aed9da587d1c6a64172792f505bafa250
Date: 2026-03-10T02:01:17.430Z (1 day ago)
Build Type: Stable
Release Track: Default
Electron: 39.6.0
Chromium: 142.0.7444.265
Node.js: 22.22.0
V8: 14.2.231.22-electron.0
OS: Windows_NT x64 10.0.26200

Additional Information

Environment: Windows 10. Other users report the same (e.g. GitHub getcursor/cursor issue 972). Workaround: in chat, use @Docs, “+ Add new doc”, and paste the same URL; Cursor does not re-index it and lets you use the doc for that chat. The downside: the doc never appears in the dropdown, so I have to re-add it and re-paste the link every time I want to reference it in a chat.
Same issue on mac when connected with ssh to the windows host.

Does this stop you from using Cursor

Sometimes - I can sometimes use Cursor

[dylanyz (Dylan G)]

Would love this to be fixed cause i want to reference my custom docs often

[deanrie]

Hey, thanks for the detailed report. The screenshot and repro steps really help.

I can see the issue. Your custom doc shows as indexed in Settings, but it doesn’t show up in the @Docs dropdown. Here are a few things to try:

1. In Settings > Indexing & Docs, click Resync to force a refresh of the docs index.
2. If that doesn’t help, delete the custom doc entry, restart Cursor, then add it again. Wait for indexing to finish before starting a new chat.
3. Try typing @Docs, then search for the doc by name or part of the name. Sometimes custom docs don’t show in the initial list but do show up in search.

Let me know if any of the above helps, or if the issue still happens after these steps.