PuppyIP Resource Center
Cloud Operations 5 min Published 2026-11-18

Cloudflare AI Search File Summaries: Reindexing, Costs, and Settings

File summaries in Cloudflare AI Search are off by default. Before enabling them, compare retrieval results and actual costs on a representative instance. Changing the setting triggers a full reindex, and summary calls are billed as Workers AI usage.

Cloudflare AI Search File summaries Reindexing Workers AI

Service eligibility and regional restrictions

PuppyIP serves only compliant overseas businesses and their authorized personnel. Proxy services are not available in mainland China. The service may only be used for lawful business activities outside mainland China. Use of this service within mainland China is prohibited.

Hosting a proxy IP or server overseas does not change these restrictions. The service must not be provided to end users in mainland China through relaying, forwarding, sharing or resale. Before use, read the Terms of Service.

Key Takeaways

  • Text documents must produce at least three chunks to qualify. Converted PDFs can qualify too.
  • AI Search keeps an existing context value, and still calls the model to generate topics. That call is billable.
  • An API update replaces the entire indexing_options object. Read the instance and preserve its current options before changing file_summary.

Which files get summaries?

Cloudflare announced indexing-time file summaries on November 17, 2026. AI Search splits documents into chunks for retrieval. A text document must produce at least three chunks at the instance's configured chunk size. Converted formats such as PDFs can qualify when they meet the threshold.

Image files are outside this feature's scope. Documents with fewer than three chunks are indexed without a summary model call. A smaller chunk size can make more files eligible and raise your costs.

Where do summaries and topics go?

AI Search stores the summary and keywords in the item's context metadata when they fit the size limit. The generation model receives that context alongside each retrieved document. If you supplied your own context through R2 or upload metadata, AI Search keeps it. Topics go in chunk context headers where space permits.

The model still makes a billable call to generate topics for eligible files with existing context. Topics can repeat across chunks and gain more weight in keyword search. Compare results for representative queries before enabling the feature on a production instance.

Why preserve the entire set of indexing options?

Enable the setting from the dashboard or set indexing_options.file_summary to true when creating or updating an instance. It is off by default. Changing it triggers a full reindex, so estimate the amount of material to reprocess and allow time to verify the result.

When using the API, the Workers binding, or Terraform that sends this configuration, read the instance first. The update replaces indexing_options as a whole and omitted options return to their defaults. Keep the existing values for the other options. A later update that omits file_summary can turn it off and trigger another full reindex.

How do you check costs and missing summaries?

Summary requests go to Workers AI through the instance's AI Gateway or the default gateway. They are billed as Workers AI usage outside the AI Search ingestion allotment. Estimate from eligible new and modified files, then check the model and usage in your own AI Gateway logs. Later syncs generally reuse summaries for unchanged files.

A file can still be indexed without a summary if the model call fails. Check chunk count, gateway and account limits, and the model result. Cloudflare documents the attempt per file version, conditions for retrying temporary failures, and gateway limits. Verify coverage after reindexing before assuming missing summaries are filled in.

Sources

Frequently Asked Questions

Why am I billed when I already provided custom context?

AI Search keeps your context and still calls the model to create topics for eligible files. That call counts as Workers AI usage.

Can I turn off file summaries without another reindex?

A change to the setting triggers a full reindex, including when you turn summaries off. Check the current options and account for reprocessing in your change plan.