1# Vectorize Configuration
2 
3## Create Index
4 
5```bash
6npx wrangler vectorize create my-index --dimensions=768 --metric=cosine
7```
8 
9**⚠️ Dimensions and metric are immutable** - cannot change after creation.
10 
11## Worker Binding
12 
13```jsonc
14// wrangler.jsonc
15{
16  "vectorize": [
17    { "binding": "VECTORIZE", "index_name": "my-index" }
18  ]
19}
20```
21 
22```typescript
23interface Env {
24  VECTORIZE: Vectorize;
25}
26```
27 
28## Metadata Indexes
29 
30**Must create BEFORE inserting vectors** - existing vectors not retroactively indexed.
31 
32```bash
33wrangler vectorize create-metadata-index my-index --property-name=category --type=string
34wrangler vectorize create-metadata-index my-index --property-name=price --type=number
35```
36 
37| Type | Use For |
38|------|---------|
39| `string` | Categories, tags (first 64 bytes indexed) |
40| `number` | Prices, timestamps |
41| `boolean` | Flags |
42 
43## CLI Commands
44 
45```bash
46# Index management
47wrangler vectorize list
48wrangler vectorize info <index-name>
49wrangler vectorize delete <index-name>
50 
51# Vector operations
52wrangler vectorize insert <index-name> --file=embeddings.ndjson
53wrangler vectorize get <index-name> --ids=id1,id2
54wrangler vectorize delete-by-ids <index-name> --ids=id1,id2
55 
56# Metadata indexes
57wrangler vectorize list-metadata-index <index-name>
58wrangler vectorize delete-metadata-index <index-name> --property-name=field
59```
60 
61## Bulk Upload (NDJSON)
62 
63```json
64{"id": "1", "values": [0.1, 0.2, ...], "metadata": {"category": "docs"}}
65{"id": "2", "values": [0.4, 0.5, ...], "namespace": "tenant-abc"}
66```
67 
68**Limits:** 5000 vectors per file, 100 MB max
69 
70## Cardinality Best Practice
71 
72Bucket high-cardinality data:
73```typescript
74// ❌ Millisecond timestamps
75metadata: { timestamp: Date.now() }
76 
77// ✅ 5-minute buckets
78metadata: { timestamp_bucket: Math.floor(Date.now() / 300000) * 300000 }
79```
80 
81## Production Checklist
82 
831. Create index with correct dimensions
842. Create metadata indexes FIRST
853. Test bulk upload
864. Configure bindings
875. Deploy Worker
886. Verify queries
89