diff --git a/src/content/docs/kv/api/write-key-value-pairs.mdx b/src/content/docs/kv/api/write-key-value-pairs.mdx index 7394756c5fc335..5e9b53c7faed9e 100644 --- a/src/content/docs/kv/api/write-key-value-pairs.mdx +++ b/src/content/docs/kv/api/write-key-value-pairs.mdx @@ -78,7 +78,7 @@ Due to the eventually consistent nature of KV, concurrent writes to the same key If concurrent writes are made to the same key, the last write will take precedence. -Writes are immediately visible to other requests in the same global network location, but can take up to 60 seconds (or the value of the `cacheTtl` parameter of the `get()` or `getWithMetadata()` methods) to be visible in other parts of the world. +Writes are eventually consistent, such that they can take up to 60 seconds (or the value of the `cacheTtl` parameter of the `get()` or `getWithMetadata()` methods) to be visible in other parts of the world. Refer to [How KV works](/kv/concepts/how-kv-works/) for more information on this topic. diff --git a/src/content/docs/kv/concepts/how-kv-works.mdx b/src/content/docs/kv/concepts/how-kv-works.mdx index 6b2611b8f76f40..43bcbfe60ad780 100644 --- a/src/content/docs/kv/concepts/how-kv-works.mdx +++ b/src/content/docs/kv/concepts/how-kv-works.mdx @@ -48,7 +48,7 @@ KV does not perform like an in-memory datastore, such as [Redis](https://redis.i ## Consistency -KV achieves high performance by being eventually-consistent. At the Cloudflare global network location at which changes are made, these changes are usually immediately visible. However, this is not guaranteed and therefore it is not advised to rely on this behaviour. In other global network locations changes may take up to 60 seconds or more to be visible as their cached versions of the data time-out. +KV achieves high performance by being eventually-consistent. Writes to KV are eventually propagated and visible at all locations up to 60 seconds or more after the write as their cached versions of the data time-out. Visibility of changes takes longer in locations which have recently read a previous version of a given key (including reads that indicated the key did not exist, which are also cached locally).