Gemini 2.5 Pro Deprecation, Shutdown Dates & Migration Guide

Runs locally in your browser — 0 bytes uploaded Synced 2026-11-12 UTC · 6 variants · 2 ecosystems

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.

Tracked Variants 6
Earliest Upcoming EOL 2026-11-17
Recommended Upgrade gemini-3.8-flash
Ecosystems Covered Google Gemini, Google Vertex AI

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.

2 of 2 configured models need migration

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.

Gemini 2.5 Pro lifecycle status, UTC shutdown dates, and replacement models across Google Gemini, Google Vertex AI
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
gemini-3.8-flash-tts Cost → Audit →
Docs ↗
gemini-2.5-pro Google Gemini DEPRECATED (19d) 2026-12-01in 19d Deprecated
gemini-3.8-flash Cost → Audit →
Docs ↗
gemini-2.5-pro Google Vertex AIGemini Models RETIRED 2026-10-2023d ago Retired
gemini-3.8-flash or gemini-3.5-flash Cost → Audit →
Docs ↗
gemini-2.5-pro-preview-03-25 Google Gemini RETIRED 2025-12-02345d ago Retired
gemini-3.8-flash Cost → Audit →
Docs ↗
gemini-2.5-pro-preview-05-06 Google Gemini RETIRED 2025-12-02345d ago Retired
gemini-3.8-flash Cost → Audit →
Docs ↗
gemini-2.5-pro-preview-06-05 Google Gemini RETIRED 2025-12-02345d ago Retired
gemini-3.8-flash Cost → Audit →
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:

  1. 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).
  2. 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.
  3. 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.

Compare sibling model families or inspect full provider-level schedules across every ecosystem hosting this family:

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.