Whatever message this page gives is out now! Go check it out!

Pinecone vector store configuration options

Last update:
May 18, 2026
This document describes settings when Pinecone is selected as the vector store provider (hosted index for embedding vectors and metadata). Pinecone does not produce embeddings: configure the embedding model separately (for example under AI Services > Embedding models, or via Source / Provider in the Embedding model section).
Cross-check field names, defaults, and pod-based options against your product build and Pinecone documentation.
Global behavior notes
  • Dimension must match embeddings: For serverless (and pod-based) indexes, the dimension must exactly match the output size of the embedding model used for this workflow. Mismatches cause creation or upsert errors.
  • API key: The Pinecone API key grants full access to indexes in your project. Store it only in secured configuration; rotate keys from the Pinecone console and restrict who can view or export settings.
  • Index creation: If the index name does not exist, your product may create it using the selected configuration type (serverless or pod-based) and the options shown—confirm behavior and required fields for each type.

Basic configuration

Field
Description
Provider
Pinecone. The selected vector store provider for this configuration.
API key
Required for normal operation. Create and copy the key from the Pinecone console (API keys). Used to authenticate all index and vector operations. If you enter a key here, treat the saved configuration as a secret.
Index name
Name of the Pinecone index for this workflow. If the index does not exist, the integration may create it automatically using your server or serverless settings below—verify auto-create support and naming rules in your environment.
Namespace
Optional partition inside the index (default is often default). Use separate namespaces for logical isolation (for example multi-tenant data). Queries typically target one namespace unless your product merges results across namespaces.
Top K
Maximum number of vectors to return from a similarity search. Must be a positive integer when set.
Min score
Optional minimum similarity score; hits below this value are dropped. Often interpreted on a 0–1 scale depending on metric and client; leave empty to return all top-K matches without a score cutoff.
---

Server configuration

Field
Description
Configuration type
Serverless — Pinecone scales capacity automatically; billing is usage-based; a good default for many new workloads. Pod-based — Dedicated pod capacity with more predictable performance characteristics; may suit steady high-throughput or legacy setups. When you switch type, the UI may show different fields (for example pod size or environment)—complete all required fields for the selected type.
---

Serverless configuration

Shown when configuration type is Serverless (field set may differ for pod-based indexes).
Field
Description
Dimension
Vector length for the index. Must match your embedding model output (for example 1536 for OpenAI text-embedding-3-small at default dimension, or 384 for common local models). Cannot be changed after the index is created.
Cloud provider
Cloud where Pinecone hosts the serverless index: for example aws, gcp, or azure. Choose a region available for that provider in your Pinecone project.
Region
Region code for the index (for example us-east-1 on AWS). Pick a region close to your application and compliant with data residency requirements.
Deletion protection
When enabled, reduces risk of accidental index deletion via API or console. Turn on for production indexes; you may disable in sandboxes when you expect to tear down indexes often.
---

Pod-based configuration

If your UI offers Pod-based as the configuration type, expect additional controls (for example pod type, size, or environment) that Pinecone requires to create or connect to a pod index. Use Pinecone’s docs for valid combinations. Dimension and metric (if exposed) must still match your embedding pipeline and index definition.
---

Embedding model (related UI)

Field
Description
Source
None — skip embedding configuration only when valid for this feature. Pre-configured — use a profile from AI Services > Embedding models. Custom — configure embedding inline.
Provider
After you choose a source, select the embedding provider (OpenAI, Mistral, and so on). That drives vector generation; Pinecone settings above define where vectors are stored and how they are queried.
---

Share this page

Was this page helpful?
We're glad. Tell us how this page helped.
We're sorry. Can you tell us what didn't work for you?
Thank you for your feedback. Your response will help improve this page.

On this page