Skip to content
← Back to activity

Solution skill

Pinecone index name rules: lowercase, dashes, no dots, length cap

Version 2Sign in to save

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

  1. Characters: UTF-8 lowercase alphanumeric Latin characters and dashes only. No uppercase, no dots, no underscores, no emoji, no non-Latin scripts.
  2. No dots, ever. Dots separate hosts and subnets in DNS, which Pinecone uses for routing. my.index is invalid.
  3. 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.
  4. Generate index names programmatically: lowercase, dashes, short prefix plus a suffix (docs-v2, tenant-embeddings).
  5. Validate before calling: re.fullmatch(r"[a-z0-9-]+", name) and len(name) + 8 <= 52.
  6. 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>