What's the difference between expirationTtl vs cachettl ? - Cloudflare Developers

© 2026 Hedgehog Software, LLC

More

Communities Docs About Terms Privacy

cosbgn

C

cosbgnOP•2/7/25, 2:59 PM

If I use for example:

expirationTtl: 21600

expirationTtl: 21600

do I also need to use cacheTtl?

cosbgn

C

cosbgnOP•2/7/25, 2:59 PM

or it will be cached by default?

cosbgn

Ccosbgn What's the difference between expirationTtl vs cachettl ?

Chaika

C

Chaika•2/7/25, 3:09 PM

expirationTtl: after this time, the key (and thus its value) will be gone forever
cacheTtl: Cache it x long, to reduce cold requests to KV's Central Stores, but of course also impacts how quickly you'll see updates if you do delete/update it

cosbgn

Ccosbgn or it will be cached by default?

Chaika

C

Chaika•2/7/25, 3:09 PM

cacheTtl is 60 seconds minimum. If you don't set it, it'll be 60s.

cosbgn

C

cosbgnOP•2/7/25, 3:14 PM

If I have a key which won't change till I manually delete it, I normally use

expirationTtl: 21600

expirationTtl: 21600

so I know that even if something goes wrong it will expire in 6 hours.

I guess it would help a lot to also add cacheTtl: 21600, right?

cache will be delete when I delete the key manually?

cosbgn

C

cosbgnOP•2/7/25, 3:19 PM

For example I do:

const [key, value] = ["something", "whatever"]

binding.put(key, value, { expirationTtl: 21600 })

Then after 5 minutes I do: 

binding.get(key, {cacheTtl:21600})

Then after 5 minutes I do:

binding.delete(key)

Then after 5 minutes I do:

binding.get(key, {cacheTtl:21600}) 
Will this last one return null or the cached value?

const [key, value] = ["something", "whatever"]

binding.put(key, value, { expirationTtl: 21600 })

Then after 5 minutes I do: 

binding.get(key, {cacheTtl:21600})

Then after 5 minutes I do:

binding.delete(key)

Then after 5 minutes I do:

binding.get(key, {cacheTtl:21600}) 
Will this last one return null or the cached value?

pandalambda2

P

pandalambda2•2/9/25, 12:31 AM

it isn't clear to me, that if cacheTtl is absent what happens - is the default min of 60 seconds applied, or is it no cache what so ever?

Walshy

W

Walshy•2/9/25, 12:38 AM

default 60s yeah

FlikTeoh

FFlikTeoh Was the KV tutorial page always this empty? https://developers.cloudflare.com/kv...

James

J

James•2/15/25, 3:14 PM

That looks like a bug. You may want to file an issue at https://github.com/cloudflare/cloudflare-docs/issues

Constantin

C

Constantin•2/16/25, 10:08 PM

hey there, any wrapper around KV to easly query thinks?

James

J

James•2/16/25, 10:15 PM

What kind of wrapper are you looking for? The KV bindings in Workers work really well, for example to read values: https://developers.cloudflare.com/kv/api/read-key-value-pairs/

James

J

James•2/16/25, 10:15 PM

Was there an issue you hit or some use-case or workflow where you think a wrapper for something would be helpful?

Constantin

C

Constantin•2/16/25, 10:30 PM

well, i'm looking for a more orm like .. thing; i'm using KV to store objects, that have some relations stored via metadata

Constantin

C

Constantin•2/16/25, 10:31 PM

i was just wondered if there's something out there that simplifies this, by adding some syntax sugar

Constantin

C

Constantin•2/16/25, 10:33 PM

but probably using prefix, would make more sense

matt

M

matt•2/18/25, 1:10 AM

would KV be a good replacement for upstash redis?

matt

M

matt•2/18/25, 1:11 AM

low-latency batch reads (eg. HMGET) would be a requirement

matt

M

matt•2/18/25, 1:11 AM

fast global replication also a must, i remember a couple of years ago reading that KV was up to 30 seconds, but there was a performance release a few months ago right?

matt

M

matt•2/18/25, 1:39 AM

oh boyo, that 30 seconds is now 60 seconds :\

matt

M

matt•2/18/25, 1:40 AM

what is cloudflare kv used for? I thought it was intended to be a redis-like db, but the performance profile is too detached from what redis offers

matt

Mmatt fast global replication also a must, i remember a couple of years ago reading th...

Isaac McFadyen

I

Isaac McFadyen•2/18/25, 2:33 AM

It's always been 60 seconds except for a short time during a rollout that ended up being rolled back.

Isaac McFadyen

I

Isaac McFadyen•2/18/25, 2:33 AM

KV is primarily designed for read-heavy workloads that rarely write.

Isaac McFadyen

I

Isaac McFadyen•2/18/25, 2:34 AM

For example, KV backs Cloudflare Pages and Workers Assets, where you deploy a site infrequently but people access often and quickly.

Isaac McFadyen

I

Isaac McFadyen•2/18/25, 2:35 AM

KV caches at your nearest colo (that's why the 60 second limit), and future reads during the time it's cached will be very low-latency.

matt

Mmatt low-latency batch reads (eg. HMGET) would be a requirement

Chaika

C

Chaika•2/18/25, 3:12 AM

not a thing currently but they talked about doing stuff for it recently: kv

matt

Mmatt fast global replication also a must, i remember a couple of years ago reading th...

Chaika

C

Chaika•2/18/25, 3:14 AM

worth keeping in mind along with what Isaac said, KV doesn't replicate as much as it does cache: https://developers.cloudflare.com/kv/concepts/how-kv-works/
Two Central stores, US and EU, all the colos/data reads are behind cache and cacheTtl. It's not actively pushing, they're pulling

Cloudflare Docs

How KV works · Cloudflare Workers KV

KV is a global, low-latency, key-value data store. It stores data in a small number of centralized data centers, then caches that data in Cloudflare's data centers after access.

nukely

N

nukely•2/24/25, 6:03 PM

Which is faster and has lower latency for random reads/writes: KV or D1?

nukely

Nnukely Which is faster and has lower latency for random reads/writes: KV or D1?

Isaac McFadyen

I

Isaac McFadyen•2/24/25, 6:20 PM

Likely KV because it's cached much more heavily than d1 (D1 is single-location), but updates may take up to 60s to be visible globally.

O

o7•2/28/25, 7:08 AM

I racked up 700K (free plan) delete operations testing worst case cleanup operations, then 1.27M with a paid plan.
The paid plan includes 1M deletes, so will I be charged fractionally for 270k deletes? Or rounded up to $5?

O

o7•2/28/25, 7:09 AM

Also is delete performance irrelevant if the key exists or not? I was deleting blank keys via the bulk api since it returned

successful_key_count

successful_key_count

regardless

FaustKreationen

F

FaustKreationen•3/2/25, 12:17 PM

hey Devs! I am bit confused with KV- encryption. The doc's are pretty clear data are encrypted on rest and transit. But when sending a new entry via Wrangler the value can be read and editetd without any encryption in the dashboard? I am planing to store API keys in KV so a encryption is necessary. I am pretty sure i am missing something?

Walshy

W

Walshy•3/2/25, 12:27 PM

Yeah, it's encrypted when stored and during transit. However, users should still be able to see their data so it's unencrypted before it's given back to you

I'd recommend encrypting yourself if you want to better control when the values are visible to you.

FaustKreationen

F

FaustKreationen•3/2/25, 12:29 PM

thank you! I will do so

saitharun

S

saitharun•3/3/25, 4:50 PM

We're experiencing consistently high latency (~1000ms) when using the Cloudflare KV REST API for basic key-value operations in our authentication flow. This seems excessive compared to the expected performance of KV storage.

Our implementation uses standard API calls following your documentation:

GET/PUT to

https://api.cloudflare.com/client/v4/accounts/{account_id}/storage/kv/namespaces/{namespace_id}/values/{key}

https://api.cloudflare.com/client/v4/accounts/{account_id}/storage/kv/namespaces/{namespace_id}/values/{key}

Authentication via X-Auth-Email and X-Auth-Key headers
Small data payloads (<2KB)

Is this latency (1 second) expected behavior for the REST API endpoint? If not, are there known optimizations, best practices, or alternative approaches you'd recommend to reduce this latency to more reasonable levels for an authentication system?

saitharun

Ssaitharun We're experiencing consistently high latency (~1000ms) when using the Cloudflare...

Isaac McFadyen

I

Isaac McFadyen•3/3/25, 4:51 PM

Rest API latency is fairly expected because the REST API is located in a few core locations and all requests must travel through those locations before hitting the end service.

Isaac McFadyen

I

Isaac McFadyen•3/3/25, 4:51 PM

In the case of KV, a lot of the benefits come because of the caching done at the edge colos where the data is retrieved from, which doesn't happen with the REST API either iirc

Isaac McFadyen

I

Isaac McFadyen•3/3/25, 4:52 PM

Your best bet might be creating a Worker that uses the KV binding (even if it's a single Worker that just services a similar API as the REST API does)

saitharun

S

saitharun•3/3/25, 4:53 PM

What's the most efficient way to access Cloudflare KV from a Python backend application?

saitharun

Ssaitharun What's the most efficient way to access Cloudflare KV from a Python backend appl...

Hard@Work

H

Hard@Work•3/3/25, 4:53 PM

Write a Worker that implements an API for you to call

Hard@Work

HHard@Work Write a Worker that implements an API for you to call

saitharun

S

saitharun•3/3/25, 4:54 PM

Thanks. Let me check.

O

o7•3/5/25, 6:23 AM

~~KV listing in the dashboard seems to be broken?~~

namespaceId:
1febbc2176164bb28d7cd90ab661e862
1febbc2176164bb28d7cd90ab661e862

edit: the only fix was recreating the namespace

O

o7•3/5/25, 6:27 AM

~~all these list ops come from a few minutes at the dashboard~~

Castio

C

Castio•3/5/25, 10:33 PM

hey everyone, I have a nextjs app that is a worker. I also have a binding for KV ready. How can I use it directly with binding in the app? KV store in NextJs App I decribed it in more details here

zegevlier

Z

zegevlier•3/6/25, 10:11 PM

I don't think it's possible to do that. If your worker only does KV reads/writes, perhaps turning off the routes there could be a solution?

zegevlier

Z

zegevlier•3/6/25, 10:12 PM

If your worker does more, I don't really have a good solution for you :/

1984 Ford Laser

1

1984 Ford Laser•3/6/25, 10:16 PM

Put auth on the Worker so a bad actor can't access it?

const [key, value] = ["something", "whatever"]

binding.put(key, value, { expirationTtl: 21600 })

Then after 5 minutes I do: 

binding.get(key, {cacheTtl:21600})

Then after 5 minutes I do:

binding.delete(key)

Then after 5 minutes I do:

binding.get(key, {cacheTtl:21600}) 
Will this last one return null or the cached value?

const [key, value] = ["something", "whatever"]

binding.put(key, value, { expirationTtl: 21600 })

Then after 5 minutes I do: 

binding.get(key, {cacheTtl:21600})

Then after 5 minutes I do:

binding.delete(key)

Then after 5 minutes I do:

binding.get(key, {cacheTtl:21600}) 
Will this last one return null or the cached value?