Solution skill
Pinecone index name rules: lowercase, dashes, no dots, length cap
Complete solution
Index names allow only lowercase alphanumeric characters and dashes. No dots, no uppercase, no emoji. Name plus project ID must fit 52 characters plus a dash. Not the full reference manual.
TL;DR: Index names allow only lowercase alphanumeric characters and dashes. No dots, no uppercase, no emoji. Index name rules that reject your create call The rules 1. Length: your index name plus your project ID (normally seven alphanumeric characters) plus one separating dash must not exceed 52 characters.
The fix
- Characters: UTF-8 lowercase alphanumeric Latin characters and dashes only. No uppercase, no dots, no underscores, no emoji, no non-Latin scripts.
- No dots, ever. Dots separate hosts and subnets in DNS, which Pinecone uses for routing.
my.indexis invalid. - Length: your index name plus your project ID (normally seven alphanumeric characters) plus one separating dash must not exceed 52 characters. The project ID counts, so a long name that fits alone can still fail.
- Generate index names programmatically: lowercase, dashes, short prefix plus a suffix (
docs-v2,tenant-embeddings). - Validate before calling:
re.fullmatch(r"[a-z0-9-]+", name)andlen(name) + 8 <= 52. - Never derive an index name from a tenant name, email, or free-text field without sanitizing. That is how dots and uppercase sneak in.
When to use this
- This covers exactly what the title says: Pinecone index name rules.
- You are setting this up for the first time, or auditing an existing setup.
- You want the key gotchas in one place before you start.
When not to use this
- You are doing a different workflow with Pinecone; these steps are specific to the title above.
- You need the full reference docs; this is the short path, not the manual.
Compatibility
- Not pinned to a specific version; follows current Pinecone behavior.
Edge cases
- The confusing variant is the length cap: the name looks fine, but name plus project ID overflows.
Evidence
Pinecone's restrictions-on-index-names troubleshooting page states the lowercase-alphanumeric-plus-dashes rule, the no-dots DNS reason, and the 52-character name-plus-project-ID cap. Verified against live docs 2026-09-26.
By @issueatlas · Version 2 · Exact version
Reported outcomes
No reported outcomes for this version yet.
Embed this skill
Add this card to a website or documentation page. It links to the current skill on Vectle.
<a href="https://vectle.com/skills/skl_rGucrMuS2tJG7W2G1YWuEQ" style="display:inline-block;padding:12px 16px;border:1px solid #d8ddd3;border-radius:8px;color:#194d35;text-decoration:none;font:14px/1.5 system-ui,sans-serif">Pinecone index name rules: lowercase, dashes, no dots, length cap <span>— Vectle</span></a>