AI Search: Add how-to guide for chunk citations in AI responses

[G4brym]

What

Adds a new how-to page under /ai-search/how-to/chunk-citations/ that explains how to extract and display source citations from AI Search responses.

Sections

• How citations work — explains the flow (retrieve chunks → pass to LLM → return chunks alongside answer)
• Display citations from chat completions — basic example mapping chunks to citation objects
• Deduplicate citations by source — group multiple chunks from the same document into a single citation
• Parse citations from a streaming response — extract the event: chunks SSE event when using stream: true
• Use scoring details to rank citations — filter low-relevance chunks and show confidence indicators
• Citation fields reference — table of all chunk fields useful for citations

Notes

All examples use the Workers binding (AiSearchNamespace) and follow the existing how-to page style (TypeScriptExample component, same frontmatter shape).

[cloudflare-docs-bot]

Review

⚠️ 2 warnings, 💡 1 suggestion found in commit 179bd15.

Code Review

This code review is in beta and may not always be helpful — use your judgment.

Warnings (2)

File	Issue
ai-search/how-to/chunk-citations.mdx line 233	Double close of streaming writer — On failure, finally at line 229 already closes the writer, then the .catch(() => writer.close()) at line 233 attempts to close it again. The second close() can reject with an unhandled promise rejection. Fix: Remove the .catch() handler or check the writer state before closing; rely on the finally block to clean up.
ai-search/how-to/chunk-citations.mdx line 207	JSON.parse without error handling — JSON.parse(line.slice(6)) can throw on malformed SSE payloads. The outer .catch only closes the writer, so the client receives a silent, truncated stream. Fix: Wrap the JSON.parse in a try/catch, and either forward an error event or terminate the response with a non-OK status when payload parsing fails.

Suggestions (1)

File	Issue
ai-search/how-to/chunk-citations.mdx line 219	Fragile SSE event state handling — After processing the first data: line of a chunks event, currentEvent is reset to "". If a single chunks event spans multiple data: lines, subsequent lines are forwarded raw instead of being transformed. Fix: Reset currentEvent only on empty lines (SSE event boundaries) or when encountering a new event: line, instead of after every data line.

Style Guide Review

✅ No style-guide issues found.

Commands

Only codeowners can run commands. Post a comment with the command to trigger it.

Command	Description
/review	Runs a review now. Incremental if a prior review exists, full if not.
/full-review	Re-reviews the entire PR diff from scratch, ignoring incremental history. Useful after a rebase, when you want a fresh review, or if the bot gets out of sync and reports issues that no longer exist.
/ignore-review-limit	Permanently lifts the 2-review automatic limit for this PR. Future pushes will trigger reviews as normal.

[github-actions]

This pull request requires reviews from CODEOWNERS as it changes files that match the following patterns:

Pattern	Owners
/src/content/docs/ai-search/	@rita3ko, @irvinebroque, @aninibread, @G4brym, @mchenco, @digizeph, @cloudflare/product-owners

[ask-bonk]

I fetched PR #31684's diff via gh pr diff and locally inspected the new chunk-citations.mdx against existing AI Search how-to pages and the Workers binding API docs. I was validating frontmatter, checking for sidebar order collisions (multiple pages use order: 5), and verifying technical accuracy in the streaming/citations examples before finishing the review.

github run

[github-actions]

Preview URL: https://179bd154.preview.developers.cloudflare.com
Preview Branch URL: https://ai-search-chunk-citations-how-to.preview.developers.cloudflare.com

Files with changes (up to 15)

Original Link	Updated Link
https://developers.cloudflare.com/ai-search/how-to/chunk-citations/	https://ai-search-chunk-citations-how-to.preview.developers.cloudflare.com/ai-search/how-to/chunk-citations/

[ALIABDULRAHMANALREHAWI]

إيقاف كل الحسابات التي تخل في نظام قواعد البيانات والأمن والخصوصية في الخميس، ٢٥ يونيو ٢٠٢٦، ١٢:١٩ github-actions[bot] < ***@***.***> كتب:

…

*github-actions[bot]* left a comment (cloudflare/cloudflare-docs#31684) <#31684 (comment)> *Preview URL:* https://179bd154.preview.developers.cloudflare.com *Preview Branch URL:* https://ai-search-chunk-citations-how-to.preview.developers.cloudflare.com *Files with changes (up to 15)* Original Link Updated Link https://developers.cloudflare.com/ai-search/how-to/chunk-citations/ https://ai-search-chunk-citations-how-to.preview.developers.cloudflare.com/ai-search/how-to/chunk-citations/ — Reply to this email directly, view it on GitHub <#31684?email_source=notifications&email_token=AT3FZNJNRRK4TMRA7DIBOU35BTVBXA5CNFSNUABFM5UWIORPF5TWS5BNNB2WEL2JONZXKZKDN5WW2ZLOOQXTINZZG43DQNBRHA4KM4TFMFZW63VKON2WE43DOJUWEZLEUVSXMZLOOSWGM33PORSXEX3DNRUWG2Y#issuecomment-4797684188>, or unsubscribe <https://github.com/notifications/unsubscribe-auth/AT3FZNIDQ2D5YMLEI5I7G7T5BTVBXAVCNFSNUABFKJSXA33TNF2G64TZHMZDSMRWG4ZTIMRUHNEXG43VMU5TINZUGIYTQNRYGMZ2C5QC> . Triage notifications, keep track of coding agent tasks and review pull requests on the go with GitHub Mobile for iOS <https://github.com/notifications/mobile/ios/AT3FZNPDQWISYXESPGS57ZL5BTVBXA5CNFSNUABFM5UWIORPF5TWS5BNNB2WEL2JONZXKZKDN5WW2ZLOOQXTINZZG43DQNBRHA4KM4TFMFZW63VKON2WE43DOJUWEZLEUVSXMZLOOSVGM33PORSXEX3JN5ZQ> and Android <https://github.com/notifications/mobile/android/AT3FZNJ6X4FNU5KYW35RTFT5BTVBXA5CNFSNUABFM5UWIORPF5TWS5BNNB2WEL2JONZXKZKDN5WW2ZLOOQXTINZZG43DQNBRHA4KM4TFMFZW63VKON2WE43DOJUWEZLEUVSXMZLOOSXGM33PORSXEX3BNZSHE33JMQ>. Download it today! You are receiving this because you are subscribed to this thread.Message ID: ***@***.***>