Skip to content

Update KV FAQ to include access guidance and rate limits #25239

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Merged
merged 4 commits into from
Sep 30, 2025
Merged

Update KV FAQ to include access guidance and rate limits #25239

Changes from all commits
Commits
Show all changes
4 commits
Select commit Hold shift + click to select a range
b05a111
Add KV access guidance and write rate limits
melhuang12 Sep 17, 2025
059630e
Add KV access guidance and write rate limits
melhuang12 Sep 17, 2025
484f9c7
PCX Review
Oxyjun Sep 18, 2025
ac3919a
Clarify KV operations bound by REST API limits
melhuang12 Sep 18, 2025
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
20 changes: 17 additions & 3 deletions src/content/docs/kv/reference/faq.mdx
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -3,10 +3,9 @@ title: FAQ
pcx_content_type: faq
sidebar:
order: 10

---

import { Glossary } from "~/components"
import { Glossary } from "~/components";

Frequently asked questions regarding Workers KV.

Expand All @@ -16,6 +15,13 @@ Frequently asked questions regarding Workers KV.

Yes, you can use Workers KV outside of Workers by using the [REST API](/api/resources/kv/) or the associated Cloudflare SDKs for the REST API. It is important to note the [limits of the REST API](/fundamentals/api/reference/limits/) that apply.

### What are the key considerations when choosing how to access KV?

When choosing how to access Workers KV, consider the following:

- **Performance**: Accessing Workers KV via the [Workers Binding API](/kv/api/write-key-value-pairs/) is generally faster than using the [REST API](/api/resources/kv/), as it avoids the overhead of HTTP requests.
- **Rate Limits**: Be aware of the different rate limits for each access method. [REST API](/api/resources/kv/) has a lower write rate limit compared to Workers Binding API. Refer to [What is the rate limit of Workers KV?](/kv/reference/faq/#what-is-the-rate-limit-of-workers-kv)

### Why can I not immediately see the updated value of a key-value pair?

Workers KV heavily caches data across the Cloudflare network. Therefore, it is possible that you read a cached value for up to the [cache TTL](/kv/api/read-key-value-pairs/#cachettl-parameter) duration.
Expand All @@ -31,7 +37,15 @@ Refer to [How KV works](/kv/concepts/how-kv-works/).
### If a Worker makes a bulk request to Workers KV, would each individual key get counted against the [Worker subrequest limit (of 1000)](/kv/platform/limits/)?

No. A bulk request to Workers KV, regardless of the amount of keys included in the request, will count as a single operation. For example, you could make
500 bulk KV requests and 500 R2 requests for a total of 1000 operations.
500 bulk KV requests and 500 R2 requests for a total of 1000 operations.

### What is the rate limit of Workers KV?

Workers KV's rate limit differs depending on the way you access it.

Operations to Workers KV via the [REST API](/api/resources/kv/) are bound by the same [limits of the REST API](/fundamentals/api/reference/limits/). This limit is shared across all Cloudflare REST API requests.

When writing to Workers KV via the [Workers Binding API](/kv/api/write-key-value-pairs/), the write rate limit is 1 write per second, per key, unlimited across KV keys.

## Pricing

Expand Down
Loading