wip

Author: thomasgauvin

src/content/changelog/kv/2025-04-10-kv-bulk-reads.mdx

@@ -0,0 +1,15 @@
+---
+title: Read multiple keys from Workers KV with bulk reads
+description: You can now retrieve up to 100 keys in a single bulk read request to Workers KV.
+products:
+  - kv
+date: 2025-01-28T14:00:00Z
+---
+
+You can now retrieve up to 100 keys in a single bulk read request made to Workers KV.
+
+This makes it easier to
+
+Workers KV namespace limits were increased from 200 to 1000 for all accounts. Higher limits for Workers KV namespaces enable better organization of key-value data, such as by category, tenant, or environment.
+
+Consult the [Workers KV limits documentation](/kv/platform/limits/) for the rest of the limits. This increased limit is available for both the Free and Paid [Workers plans](/workers/platform/pricing/).

src/content/docs/kv/api/read-key-value-pairs.mdx

@@ -8,70 +8,71 @@ sidebar:
 To get the value for a given key, call the `get()` method of the [KV binding](/kv/concepts/kv-bindings/) on any [KV namespace](/kv/concepts/kv-namespaces/) you have bound to your Worker code:
 
 ```js
+// Read individual key
 env.NAMESPACE.get(key);
+
+// Read multiple keys
+env.NAMESPACE.get(keys);
 ```
 
 The `get()` method returns a promise you can `await` on to get the value.
 
 If you request a single key as a string, you will get a single response in the promise. If the key is not found, the promise will resolve with the literal value `null`.
 
-Instead of a single key, you can also request an array of keys. In this case, the response is a map with the key-value pairs.
-
-#### Example
-
-An example of reading a key from within a Worker:
+You can also request an array of keys. The return value with be a `Map` of the key-value pairs found,
+with keys not found having `null` values.
 
 ```js
 export default {
 	async fetch(request, env, ctx) {
 		try {
+			// Read single key, returns value or null
 			const value = await env.NAMESPACE.get("first-key");
-			test;
 
-			if (value === null) {
-				return new Response("Value not found", { status: 404 });
-			}
-			return new Response(value);
-		} catch (e) {
-			return new Response(e.message, { status: 500 });
-		}
-	},
-};
-```
+			// Read multiple keys, returns Map of values
+			const values = await env.NAMESPACE.get(["first-key", "second-key"]);
 
-Or if you request multiple keys:
+			// Read single key with metadata, returns value or null
+			const valueWithMetadata = await env.NAMESPACE.getWithMetadata("first-key");
 
-```js
-export default {
-	async fetch(request, env, ctx) {
-		try {
-			const value = await env.NAMESPACE.get(["first-key", "second-key"]);
+			// Read multiple keys with metadata, returns Map of values
+			const valuesWithMetadata = await env.NAMESPACE.getWithMetadata(["first-key", "second-key"]);
 
-			return new Response(
-				"values: " + value.get("second-key") + " " + value.get("second-key"),
-			);
+			return new Response({
+				value: value,
+				values: Object.fromEntries(values),
+				valueWithMetadata: valueWithMetadata,
+				valuesWithMetadata: Object.fromEntries(valuesWithMetadata)
+			});
 		} catch (e) {
 			return new Response(e.message, { status: 500 });
 		}
 	},
 };
 ```
 
+:::note
+
+`get()` and `getWithMetadata()` methods may return stale values. If a given key has recently been read in a given location, writes or updates to the key made in other locations may take up to 60 seconds (or the duration of the `cacheTtl`) to display.
+
+:::
+
+
 ## Reference
 
 The following methods are provided to read from KV:
 
-- [get()](#get-method)
-- [getWithMetadata()](#getwithmetadata-method)
+- [get()](#request-a-single-key-with-getkey-string)
+- [getWithMetadata()](#request-multiple-keys-with-getkeys-string)
 
 ### `get()` method
 
 Use the `get()` method to get a single value, or multiple values if given multiple keys:
 
-- Read single keys with [get(key)](#request-a-single-key)
-- Read multiple keys with [get([keys])](#request-multiple-keys)
+- Read single keys with [get(key: string)](#request-a-single-key-with-getkey-string)
+- Read multiple keys with [get(keys: string[])](#request-multiple-keys-with-getkeys-string)
 
-#### Request a single key
+#### Request a single key with `get(key: string)`
 
 To get the value for a single key, call the `get()` method on any KV namespace you have bound to your Worker code with:
 
@@ -102,9 +103,7 @@ env.NAMESPACE.get(key, options?);
     - `arrayBuffer`: An [`ArrayBuffer`](https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/ArrayBuffer) instance.
     - `stream`: A [`ReadableStream`](https://developer.mozilla.org/en-US/docs/Web/API/ReadableStream).
 
-The `get()` method may return stale values. If a given key has recently been read in a given location, writes or updates to the key made in other locations may take up to 60 seconds (or the duration of the `cacheTtl`) to display.
-
-#### Request multiple keys
+#### Request multiple keys with `get(keys: string[])`
 
 To get the values for multiple keys, call the `get()` method on any KV namespace you have bound to your Worker code with:
 
@@ -134,22 +133,21 @@ The `.get()` function to read multiple keys does not support `arrayBuffer` or `s
 
 ##### Response
 
-- `response`: `Promise<Map<string, string | Object | null>`
-  - The value for the requested KV pair. The response type will depend on the `type` parameter provided for the `get()` command as follows:
+- `response`: `Promise<Map<string, string | Object | null>>`
+  - The value for the requested KV pair. If no key is found, `null` is returned for the key. The response type will depend on the `type` parameter provided for the `get()` command as follows:
     - `text`: A `string` (default).
     - `json`: An object decoded from a JSON string.
 
-When requesting multiple keys, the promise will never resolve to a null value. It may, however, resolve to a map that contains a key that corresponds to a null value, similar to what happens for a single get.
-
-You cannot request over 25 MB of data. If you do, the request will fail with a `413` Error.
-
-The `get()` method may return stale values. If a given key has recently been read in a given location, writes or updates to the key made in other locations may take up to 60 seconds (or the duration of the `cacheTtl`) to display.
+The limit of the response size is 25 MB. Responses above this size will fail with a `413 Error` error message.
 
 ### `getWithMetadata()` method
 
-Use the `getWithMetadata()` method to get a single value, or multiple values if given multiple keys.
+Use the `getWithMetadata()` method to get a single value along with its metadata, or multiple values with their metadata:
 
-#### Request a single key
+- Read single keys with [getWithMetadata(key: string)](#request-a-single-key-with-getwithmetadatakey-string)
+- Read multiple keys with [getWithMetadata(keys: string[])](#request-multiple-keys-with-getwithmetadatakeys-string)
+
+#### Request a single key with `getWithMetadata(key: string)`
 
 To get the value for a given key along with its metadata, call the `getWithMetadata()` method on any KV namespace you have bound to your Worker code:
 
@@ -188,31 +186,7 @@ metadata: string | null
 
 If there is no metadata associated with the requested key-value pair, `null` will be returned for metadata.
 
-The `getWithMetadata()` method may return stale values. If a given key has recently been read in a given location, writes or updates to the key made in other locations may take up to 60 seconds (or the duration of the `cacheTtl`) to display.
-
-##### Example
-
-An example of reading a key with metadata from within a Worker:
-
-```js
-export default {
-	async fetch(request, env, ctx) {
-		try {
-			const { value, metadata } =
-				await env.NAMESPACE.getWithMetadata("first-key");
-
-			if (value === null) {
-				return new Response("Value not found", { status: 404 });
-			}
-			return new Response(value);
-		} catch (e) {
-			return new Response(e.message, { status: 500 });
-		}
-	},
-};
-```
-
-#### Request multiple keys
+#### Request multiple keys with `getWithMetadata(keys: string[])`
 
 To get the values for a given set of keys along with their metadata, call the `getWithMetadata()` method on any KV namespace you have bound to your Worker code with:
 
@@ -252,27 +226,7 @@ metadata: string | Object | null
 
 If there is no metadata associated with the requested key-value pair, `null` will be returned for metadata.
 
-You cannot request over 25MB of data. If you do, the request will fail with a `413` Error .
-
-##### Example
-
-An example of reading a key with metadata from within a Worker:
-
-```js
-export default {
-	async fetch(request, env, ctx) {
-		try {
-			const response = await env.NAMESPACE.getWithMetadata(["first-key"]);
-			const firstValue = response.get("first-key");
-			return new Response(
-				"value: " + firstValue?.value + " metadata: " + firstValue?.metadata,
-			);
-		} catch (e) {
-			return new Response(e.message, { status: 500 });
-		}
-	},
-};
-```
+The limit of the response size is 25 MB. Responses above this size will fail with a `413 Error` error message.
 
 ## Guidance