Gemini 2.5 Pro Deprecation, Shutdown Dates & Migration Guide
Track confirmed UTC deprecation and shutdown dates for Gemini 2.5 Pro (Google) across Google Gemini, Google Vertex AI. Preview gemini-2.5-pro → gemini-3.8-flash 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 (gemini-2.5-pro → gemini-3.8-flash)
# GEMINI_MODEL: gemini-2.5-pro -> gemini-3.8-flash [DEPRECATED · EOL 2026-12-01]
- GEMINI_MODEL="gemini-2.5-pro"
+ GEMINI_MODEL="gemini-3.8-flash"
# model: gemini-2.5-pro -> gemini-3.8-flash [DEPRECATED · EOL 2026-12-01]
- model: gemini/gemini-2.5-pro
+ model: gemini/gemini-3.8-flash
2. Cross-Ecosystem Gemini 2.5 Pro Lifecycle Matrix (6)
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 |
|---|---|---|---|---|---|---|
gemini-2.5-pro-preview-tts |
Google Gemini | DEPRECATED (5d) | 2026-11-17in 5d | Deprecated | Docs ↗ | |
gemini-2.5-pro |
Google Gemini | DEPRECATED (19d) | 2026-12-01in 19d | Deprecated | Docs ↗ | |
gemini-2.5-pro |
Google Vertex AIGemini Models | RETIRED | 2026-10-2023d ago | Retired | Docs ↗ | |
gemini-2.5-pro-preview-03-25 |
Google Gemini | RETIRED | 2025-12-02345d ago | Retired | Docs ↗ | |
gemini-2.5-pro-preview-05-06 |
Google Gemini | RETIRED | 2025-12-02345d ago | Retired | Docs ↗ | |
gemini-2.5-pro-preview-06-05 |
Google Gemini | RETIRED | 2025-12-02345d ago | Retired | Docs ↗ |
3. Production Migration Checklist (gemini-2.5-pro → gemini-3.8-flash)
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 Gemini 2.5 Pro family (2 deprecated, 4 retired, 0 active variants tracked). - Benchmark successor quality & token pricing: Validate structured output schemas, tool-calling payloads, and latency against
gemini-3.8-flash, 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 Gemini 2.5 Pro 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 Flash & Flash-Lite
DEPRECATED (5d)Google Text & Gemini Embeddings (004 / Gecko)
DEPRECATED (140d)5. Gemini 2.5 Pro Deprecation & Upgrade FAQ
Is Gemini 2.5 Pro deprecated or retired across Google Gemini, Google Vertex AI?
LLMEOL tracks 6 Gemini 2.5 Pro variants across Google Gemini, Google Vertex AI: 2 deprecated with scheduled shutdowns, 4 retired past their UTC EOL date, and 0 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 gemini-2.5-pro?
The primary recommended upgrade target for gemini-2.5-pro is gemini-3.8-flash. Always test prompt formatting, max output tokens, and tool schemas on gemini-3.8-flash, and compare token pricing in DevToken before switching production traffic.
How can I replace gemini-2.5-pro 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.