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.

Note

KV namespace IDs are public and bound to your account.

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:

wrangler.toml

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. Log in to the Cloudflare dashboard ↗.
2. Go to Workers & Pages.
3. Select your Worker.
4. Select Settings > Bindings.
5. Select Add.
6. Select KV Namespace.
7. Enter your desired variable name (the name of the binding).
8. Select the KV namespace you wish to bind the Worker to.
9. Select Deploy.