starter.wiki

Globally distributed key-value store

Cloudflare Workers KV

A Cloudflare key-value store optimized for high-volume global reads by caching values near Workers execution locations.

Visit official site

Editorial verdict

Choose Workers KV for read-heavy global state, configuration, personalization, or cache-like data when stale reads are acceptable. Do not make it the primary store for rapidly changing authoritative state or coordination that requires immediate write visibility.12

Best for

  • Globally distributed read-heavy Workers workloads
  • Configuration, routing, personalization, or lookup data that changes relatively infrequently
  • Values that can tolerate eventual consistency and documented object and operation limits
123

Not ideal for

  • Counters, locks, coordination, or frequent writes to the same key
  • Authoritative mutable records requiring immediate read-after-write visibility globally
  • Applications outside Cloudflare that prioritize provider-independent storage access
123
Main trade-off

Workers KV provides simple globally cached reads and Workers integration, but accepts eventual consistency, cold-read behavior, same-key write limits, object limits, operation-based pricing, and Cloudflare coupling.1234

Product boundary

Whether a read-heavy Workers workload can accept eventual global visibility and simple key-value semantics in exchange for low-latency distributed reads.

Workers KV writes to central stores and caches values in Cloudflare locations after access. It is eventually consistent, limits writes to the same key, and is not a transactional database or coordination primitive.23

For: Cloudflare Workers applications with high read distribution, relatively infrequent writes, and explicit tolerance for eventual consistency

  • Writes to the same key approach the current one-per-second limit.
  • The application requires immediate global read-after-write behavior.
  • The value size, key size, operation count, or cache TTL boundary does not fit.
  • Cloudflare-specific bindings conflict with the portability requirement.

Why teams consider Cloudflare Workers KV

  • Global read distributionKV caches read values in Cloudflare locations after fetching them through regional and central tiers.23
  • Workers-native bindingWorkers can access KV namespaces through a direct platform binding.123
  • Simple operation pricingFree and Paid Workers plans publish per-key read, write, delete, list, and storage allowances.234

Pricing

Workers KV is included in Workers Free and Paid plans. Paid usage separately meters key reads, writes, deletes, list operations, and stored GB-months; Workers runtime remains a separate cost boundary.4

Prototype

Workers Free

Currently includes 100,000 reads, 1,000 writes, 1,000 deletes, and 1,000 list requests per day plus 1 GB storage.4

Production

Workers Paid

Currently includes 10 million reads, 1 million writes, 1 million deletes, 1 million list requests per month, and 1 GB storage; overages are $0.50 per million reads, $5 per million writes, deletes, or lists, and $0.50 per GB-month.4

Transfer
Workers KV currently lists no separate data transfer or egress charge4
Same-key write limit
One write per second to the same key under current limits4
Pricing checked View official pricing

Cloudflare Workers KV vs alternatives

Upstash Redis

Choose when
Choose it when supported Redis data structures, REST or TCP access, and persistent key-addressed state matter more than KV's read distribution.
Compared with Cloudflare Workers KV
Compatibility, consistency, command, storage, bandwidth, and plan limits differ.5

Amazon DynamoDB

Choose when
Choose it for durable authoritative records, partition-key access, conditional writes, and AWS-native scale.
Compared with Cloudflare Workers KV
The data model, regional design, indexing, and cost structure are more involved.6

Resources and sources

Official product, policy, and pricing

  • Cloudflare Workers KV documentation
    Open
  • How Workers KV works
    Open
  • Workers KV limits
    Open
  • Workers KV pricing
    Open

Related tasks

  1. 1
    Cloudflare Workers KV documentation

    Cloudflare · Accessed Official

  2. 2
    How Workers KV works

    Cloudflare · Accessed Official

  3. 3
    Workers KV limits

    Cloudflare · Accessed Official

  4. 4
    Workers KV pricing

    Cloudflare · Accessed Official

  5. 5
    Upstash Redis getting started

    Upstash · Accessed Official

  6. 6
    Amazon DynamoDB introduction

    Amazon Web Services · Accessed Official