Cloudflare Docs
KV
Cloudflare Docs
KV
Edit this page
Give us feedback
Set theme to dark (⇧+D)
  1. Products
  2. KV
  3. Reference
  4. KV namespaces

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.

​​ 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 > Variables.
  5. Go to KV Namespace Bindings.
  6. Select Add binding.