KV namespaces

A KV namespace is a key-value database replicated to Cloudflare’s global network.

Bind your KV namespaces through Wrangler or via the Cloudflare dashboard.

Jurisdictions

Namespaces can optionally be restricted to a jurisdiction to durably store data only within a specific region. Refer to Data location for more information.

Bind your KV namespace through Wrangler

To bind KV namespaces to your Worker, assign an array of the below object to the kv_namespaces key.

• binding string required

  • The binding name used to refer to the KV namespace.

• id string required

  • The ID of the KV namespace.

• preview_id string optional

  • The ID of the KV namespace used during wrangler dev.

Example:

{
	"kv_namespaces": [
		{
			"binding": "<TEST_NAMESPACE>",
			"id": "<TEST_ID>"
		}
	]
}

[[kv_namespaces]]
binding = "<TEST_NAMESPACE>"
id = "<TEST_ID>"

Bind your KV namespace via the dashboard

To bind the namespace to your Worker in the Cloudflare dashboard:

1. In the Cloudflare dashboard, go to the Workers & Pages page.

   dash.cloudflare.com↗

2. Select your Worker.

3. Select Settings > Bindings.

4. Select Add.

5. Select KV Namespace.

6. Enter your desired variable name (the name of the binding).

7. Select the KV namespace you wish to bind the Worker to.

8. Select Deploy.