Skip to content
Cloudflare Docs

Workers KV namespaces

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

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

Bind your Workers KV namespace through Wrangler

To bind Workers 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 Workers KV namespace.

  • id string required

    • The ID of the Workers KV namespace.

  • preview_id string optional

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

Example:

wrangler.toml
kv_namespaces = [
  { binding = "<TEST_NAMESPACE>", id = "<TEST_ID>" }
]

Bind your Workers 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.
Cloudflare DashboardDiscordCommunityLearning CenterSupport Portal