Google Text & Gemini Embeddings (004 / Gecko) Deprecation, Shutdown Dates & Migration Guide
Track confirmed UTC deprecation and shutdown dates for Google Text & Gemini Embeddings (004 / Gecko) (Google) across Google Gemini, Google Vertex AI. Preview text-embedding-004 → gemini-embedding-001 upgrades locally below, audit full configs in the Model Config Auditor, or benchmark token pricing in DevToken.
1. Quick .env & SDK Snippet Replacement Matcher
Edit or paste your .env assignment, LiteLLM route, or SDK model identifier below to check live 3-state EOL status and copy a ready-to-apply replacement diff locally in your browser.
Replacement Diff Preview (text-embedding-004 → gemini-embedding-001)
# VERTEX_MODEL: text-embedding-004 -> gemini-embedding-001 [DEPRECATED · EOL 2027-04-01]
- VERTEX_MODEL="text-embedding-004"
+ VERTEX_MODEL="gemini-embedding-001"
# GEMINI_MODEL: gemini-embedding-001 -> gemini-embedding-2 [DEPRECATED · EOL 2028-05-14]
- GEMINI_MODEL="gemini-embedding-001"
+ GEMINI_MODEL="gemini-embedding-2"
2. Cross-Ecosystem Google Text & Gemini Embeddings (004 / Gecko) Lifecycle Matrix (18)
Direct vendor APIs and cloud platforms retire dated snapshots on independent schedules. Verify the exact model ID, vendor lifecycle stage, and UTC shutdown date matching your deployment.
| Model ID | Provider | Calculated Status | Confirmed Shutdown (UTC) | Vendor Lifecycle | Replacement & Migration | Source |
|---|---|---|---|---|---|---|
multimodalembedding@001 |
Google Vertex AIGemini Models | DEPRECATED (140d) | 2027-04-01in 140d | Deprecated | Docs ↗ | |
text-embedding-004 |
Google Vertex AIGemini Models | DEPRECATED (140d) | 2027-04-01in 140d | Deprecated | Docs ↗ | |
text-embedding-005 |
Google Vertex AIGemini Models | DEPRECATED (140d) | 2027-04-01in 140d | Deprecated | Docs ↗ | |
text-multilingual-embedding-002 |
Google Vertex AIGemini Models | DEPRECATED (140d) | 2027-04-01in 140d | Deprecated | Docs ↗ | |
gemini-embedding-001 |
Google Gemini | DEPRECATED (549d) | 2028-05-14in 549d | Deprecated | Docs ↗ | |
gemini-embedding-2-preview |
Google Gemini | RETIRED | 2026-11-066d ago | Retired | Docs ↗ | |
text-embedding-004 |
Google Gemini | RETIRED | 2026-01-14302d ago | Retired | Docs ↗ | |
embedding-001 |
Google Gemini | RETIRED | 2025-10-30378d ago | Retired | Docs ↗ | |
embedding-gecko-001 |
Google Gemini | RETIRED | 2025-10-30378d ago | Retired | Docs ↗ | |
gemini-embedding-exp |
Google Gemini | RETIRED | 2025-10-30378d ago | Retired | Docs ↗ | |
gemini-embedding-exp-03-07 |
Google Gemini | RETIRED | 2025-10-30378d ago | Retired | Docs ↗ | |
textembedding-gecko-multilingual@001 |
Google Vertex AIGemini Models | RETIRED | 2025-05-24537d ago | Retired | Docs ↗ | |
textembedding-gecko@003\* |
Google Vertex AIGemini Models | RETIRED | 2025-05-24537d ago | Retired | Docs ↗ | |
textembedding-gecko@001 |
Google Vertex AIGemini Models | RETIRED | 2025-04-21570d ago | Retired | Docs ↗ | |
textembedding-gecko@002 |
Google Vertex AIGemini Models | RETIRED | 2025-04-21570d ago | Retired | Docs ↗ | |
gemini-embedding-2 |
Google Gemini | ACTIVE | No EOL | Active | — | — |
gemini-embedding-001 |
Google Vertex AIGemini Models | ACTIVE | No EOL | Active | — | — |
gemini-embedding-2 |
Google Vertex AIGemini Models | ACTIVE | No EOL | Active | — | — |
3. Production Migration Checklist (text-embedding-004 → gemini-embedding-001)
Follow this deterministic engineering sequence before retiring pinned snapshots in production services and SDK clients:
- Inventory pinned model IDs: Search repositories and deployment manifests for
GEMINI_MODEL,gemini/LiteLLM routes, and dated snapshot strings in the Google Text & Gemini Embeddings (004 / Gecko) family (5 deprecated, 10 retired, 3 active variants tracked). - Benchmark successor quality & token pricing: Validate structured output schemas, tool-calling payloads, and latency against
gemini-embedding-001, then compare input, output, and cached token rates in DevToken. - Enforce keyless CI guardrails: Wire RSS, Atom, iCal feeds & CI Guard into pull-request checks so retired or deprecated Google Text & Gemini Embeddings (004 / Gecko) identifiers cannot re-enter production.
4. Related Google & Ecosystem Migration Guides
Compare sibling model families or inspect full provider-level schedules across every ecosystem hosting this family:
Gemini 1.5 Pro
RETIREDGemini 1.5 Flash
RETIREDGemini 2.0 Flash & Flash-Lite
RETIREDGemini 2.5 Pro
DEPRECATED (5d)Gemini 2.5 Flash & Flash-Lite
DEPRECATED (5d)5. Google Text & Gemini Embeddings (004 / Gecko) Deprecation & Upgrade FAQ
Is Google Text & Gemini Embeddings (004 / Gecko) deprecated or retired across Google Gemini, Google Vertex AI?
LLMEOL tracks 18 Google Text & Gemini Embeddings (004 / Gecko) variants across Google Gemini, Google Vertex AI: 5 deprecated with scheduled shutdowns, 10 retired past their UTC EOL date, and 3 active with no announced shutdown date. Check the cross-ecosystem matrix above for exact snapshot dates.
What is the recommended replacement model when migrating off text-embedding-004?
The primary recommended upgrade target for text-embedding-004 is gemini-embedding-001. Always test prompt formatting, max output tokens, and tool schemas on gemini-embedding-001, and compare token pricing in DevToken before switching production traffic.
How can I replace text-embedding-004 in .env and LiteLLM configs safely?
Paste your GEMINI_MODEL assignment or LiteLLM model block into the Quick Replacement Matcher on this page to generate an exact diff, or open the full Local Model Config Auditor to scan multi-service manifests with zero network upload.