--- description: Wrangler CLI commands for creating, managing, and querying Vectorize indexes. title: Wrangler commands image: https://developers.cloudflare.com/og-docs.png --- [Skip to content](#main-content) > Documentation Index > Fetch the complete documentation index at: https://developers.cloudflare.com/vectorize/llms.txt > Use this file to discover all available pages before exploring further. # Wrangler commands Last updated Sep 1, 2026|Copy as Markdown| [View as Markdown](https://0285ca83.previews.developers.cloudflare.com/vectorize/reference/wrangler-commands/index.md)| [Agent setup](https://0285ca83.previews.developers.cloudflare.com/agent-setup/) Vectorize uses the following [Wrangler Commands](https://0285ca83.previews.developers.cloudflare.com/workers/wrangler/commands/). ## `vectorize create` Create a Vectorize index npmyarnpnpm ``` npx wrangler vectorize create [NAME] ``` ``` yarn wrangler vectorize create [NAME] ``` ``` pnpm wrangler vectorize create [NAME] ``` - `[NAME]` `string` required The name of the Vectorize index to create (must be unique). - `--dimensions` `number` The dimension size to configure this index for, based on the output dimensions of your ML model. - `--metric` `string` The distance metric to use for searching within the index. - `--preset` `string` The name of an preset representing an embeddings model: Vectorize will configure the dimensions and distance metric for you when provided. - `--description` `string` An optional description for this index. - `--json` `boolean` default: false Return output as JSON - `--deprecated-v1` `boolean` default: false Create a deprecated Vectorize V1 index. This is not recommended and indexes created with this option need all other Vectorize operations to have this option enabled. - `--use-remote` `boolean` Use a remote binding when adding the newly created resource to your config - `--update-config` `boolean` Automatically update your config file with the newly added resource - `--binding` `string` The binding name of this resource in your Worker

Global flags

- --vboolean alias: --version Show version number - --cwdstringRun as if Wrangler was started in the specified directory instead of the current working directory - --configstring alias: --c Path to Wrangler configuration file - --envstring alias: --e Environment to use for operations, and for selecting .env and .dev.vars files - --env-filestringPath to an .env file to load - can be specified multiple times - values from earlier files are overridden by values in later files - --experimental-provisionboolean aliases: --x-provisiondefault: true Experimental: Enable automatic resource provisioning - --experimental-auto-createboolean alias: --x-auto-createdefault: true Automatically provision draft bindings with new resources - --install-skillsboolean default: false Install Cloudflare skills for detected AI coding agents before running the command - --profilestringUse a specific auth profile

## `vectorize delete` Delete a Vectorize index npmyarnpnpm ``` npx wrangler vectorize delete [NAME] ``` ``` yarn wrangler vectorize delete [NAME] ``` ``` pnpm wrangler vectorize delete [NAME] ``` - `[NAME]` `string` required The name of the Vectorize index - `--force` `boolean` alias: --ydefault: false Skip confirmation - `--deprecated-v1` `boolean` default: false Delete a deprecated Vectorize V1 index.

Global flags

## `vectorize get` Get a Vectorize index by name npmyarnpnpm ``` npx wrangler vectorize get [NAME] ``` ``` yarn wrangler vectorize get [NAME] ``` ``` pnpm wrangler vectorize get [NAME] ``` - `[NAME]` `string` required The name of the Vectorize index. - `--json` `boolean` default: false Return output as JSON - `--deprecated-v1` `boolean` default: false Fetch a deprecated V1 Vectorize index. This must be enabled if the index was created with V1 option.

Global flags

## `vectorize list` List your Vectorize indexes npmyarnpnpm ``` npx wrangler vectorize list ``` ``` yarn wrangler vectorize list ``` ``` pnpm wrangler vectorize list ``` - `--json` `boolean` default: false Return output as JSON - `--deprecated-v1` `boolean` default: false List deprecated Vectorize V1 indexes for your account.

Global flags

## `vectorize list-vectors` List vector identifiers in a Vectorize index npmyarnpnpm ``` npx wrangler vectorize list-vectors [NAME] ``` ``` yarn wrangler vectorize list-vectors [NAME] ``` ``` pnpm wrangler vectorize list-vectors [NAME] ``` - `[NAME]` `string` required The name of the Vectorize index - `--count` `number` Maximum number of vectors to return (1-1000) - `--cursor` `string` Cursor for pagination to get the next page of results - `--json` `boolean` default: false Return output as JSON

Global flags

## `vectorize query` Query a Vectorize index npmyarnpnpm ``` npx wrangler vectorize query [NAME] ``` ``` yarn wrangler vectorize query [NAME] ``` ``` pnpm wrangler vectorize query [NAME] ``` - `[NAME]` `string` required The name of the Vectorize index - `--vector` `number` Vector to query the Vectorize Index - `--vector-id` `string` Identifier for a vector in the index against which the index should be queried - `--top-k` `number` default: 5 The number of results (nearest neighbors) to return - `--return-values` `boolean` default: false Specify if the vector values should be included in the results - `--return-metadata` `string` default: none Specify if the vector metadata should be included in the results - `--namespace` `string` Filter the query results based on this namespace - `--filter` `string` Filter the query results based on this metadata filter.

Global flags

## `vectorize insert` Insert vectors into a Vectorize index npmyarnpnpm ``` npx wrangler vectorize insert [NAME] ``` ``` yarn wrangler vectorize insert [NAME] ``` ``` pnpm wrangler vectorize insert [NAME] ``` - `[NAME]` `string` required The name of the Vectorize index. - `--file` `string` required A file containing line separated json (ndjson) vector objects. - `--batch-size` `number` default: 1000 Number of vector records to include when sending to the Cloudflare API. - `--json` `boolean` default: false return output as JSON - `--deprecated-v1` `boolean` default: false Insert into a deprecated V1 Vectorize index. This must be enabled if the index was created with the V1 option.

Global flags

## `vectorize upsert` Upsert vectors into a Vectorize index npmyarnpnpm ``` npx wrangler vectorize upsert [NAME] ``` ``` yarn wrangler vectorize upsert [NAME] ``` ``` pnpm wrangler vectorize upsert [NAME] ``` - `[NAME]` `string` required The name of the Vectorize index. - `--file` `string` required A file containing line separated json (ndjson) vector objects. - `--batch-size` `number` default: 5000 Number of vector records to include in a single upsert batch when sending to the Cloudflare API. - `--json` `boolean` default: false return output as JSON

Global flags

## `vectorize get-vectors` Get vectors from a Vectorize index npmyarnpnpm ``` npx wrangler vectorize get-vectors [NAME] ``` ``` yarn wrangler vectorize get-vectors [NAME] ``` ``` pnpm wrangler vectorize get-vectors [NAME] ``` - `[NAME]` `string` required The name of the Vectorize index. - `--ids` `string` required Vector identifiers to be fetched from the Vectorize Index. Example: `--ids a 'b' 1 '2'`

Global flags

## `vectorize delete-vectors` Delete vectors in a Vectorize index npmyarnpnpm ``` npx wrangler vectorize delete-vectors [NAME] ``` ``` yarn wrangler vectorize delete-vectors [NAME] ``` ``` pnpm wrangler vectorize delete-vectors [NAME] ``` - `[NAME]` `string` required The name of the Vectorize index. - `--ids` `string` required Vector identifiers to be deleted from the Vectorize Index. Example: `--ids a 'b' 1 '2'`

Global flags

## `vectorize info` Get additional details about the index npmyarnpnpm ``` npx wrangler vectorize info [NAME] ``` ``` yarn wrangler vectorize info [NAME] ``` ``` pnpm wrangler vectorize info [NAME] ``` - `[NAME]` `string` required The name of the Vectorize index. - `--json` `boolean` default: false return output as JSON

Global flags

## `vectorize create-metadata-index` Enable metadata filtering on the specified property npmyarnpnpm ``` npx wrangler vectorize create-metadata-index [NAME] ``` ``` yarn wrangler vectorize create-metadata-index [NAME] ``` ``` pnpm wrangler vectorize create-metadata-index [NAME] ``` - `[NAME]` `string` required The name of the Vectorize index. - `--propertyName` `string` required The name of the metadata property to index. - `--type` `string` required The type of metadata property to index. Valid types are 'string', 'number' and 'boolean'.

Global flags

## `vectorize list-metadata-index` List metadata properties on which metadata filtering is enabled npmyarnpnpm ``` npx wrangler vectorize list-metadata-index [NAME] ``` ``` yarn wrangler vectorize list-metadata-index [NAME] ``` ``` pnpm wrangler vectorize list-metadata-index [NAME] ``` - `[NAME]` `string` required The name of the Vectorize index. - `--json` `boolean` default: false return output as JSON

Global flags

## `vectorize delete-metadata-index` Delete metadata indexes npmyarnpnpm ``` npx wrangler vectorize delete-metadata-index [NAME] ``` ``` yarn wrangler vectorize delete-metadata-index [NAME] ``` ``` pnpm wrangler vectorize delete-metadata-index [NAME] ``` - `[NAME]` `string` required The name of the Vectorize index. - `--propertyName` `string` required The name of the metadata property to index.

Global flags

Was this helpful? YesNo ## On this page [![](https://0285ca83.previews.developers.cloudflare.com/_astro/logo.te5VL_aD.svg)Docs](https://0285ca83.previews.developers.cloudflare.com/) ```json {"@context":"https://schema.org","@type":"TechArticle","@id":"https://developers.cloudflare.com/vectorize/reference/wrangler-commands/#page","headline":"Wrangler commands · Cloudflare Vectorize docs","description":"Wrangler CLI commands for creating, managing, and querying Vectorize indexes.","url":"https://developers.cloudflare.com/vectorize/reference/wrangler-commands/","inLanguage":"en","image":"https://developers.cloudflare.com/og-docs.png","dateModified":"2026-09-01","publisher":{"@type":"Organization","name":"Cloudflare","description":"One platform for your apps, agents, and workforce. Build, secure, and scale without managing infrastructure","url":"https://www.cloudflare.com/","sameAs":["https://github.com/cloudflare","https://www.linkedin.com/company/cloudflare","https://x.com/cloudflare"],"logo":{"@type":"ImageObject","url":"https://developers.cloudflare.com/logo.svg"},"address":{"@type":"PostalAddress","streetAddress":"101 Townsend St","addressLocality":"San Francisco","addressRegion":"CA","postalCode":"94107","addressCountry":"US"},"contactPoint":[{"@type":"ContactPoint","contactType":"Customer Support","url":"https://support.cloudflare.com/","availableLanguage":["English"]},{"@type":"ContactPoint","contactType":"Sales","url":"https://www.cloudflare.com/contact/","availableLanguage":["English"]}]},"isPartOf":{"@type":"WebSite","@id":"https://developers.cloudflare.com/#website","name":"Cloudflare Docs","url":"https://developers.cloudflare.com/"}} ```