# embedding-2-preview: retirement date, replacement, how to migrate

`embedding-2-preview` was retired on 2026-08-10 on the Gemini API; the vendor's named replacement is `gemini-embedding-2`.

This date is the one in the Gemini notice for the Gemini API. Other platforms that host the same model publish their own dates.

## Facts

- Retirement date: 2026-08-10
- Status: Retired, 65 days ago
- Replacement: `gemini-embedding-2`
- Official notice: https://ai.google.dev/gemini-api/docs/deprecations#embedding-models
- Record date: 2026-09-23

## Find it in your code

```sh
npx @upseam/cli inspect gemini
grep -rnF 'embedding-2-preview' .
```

## Migrate

- `embedding-2-preview` -> `gemini-embedding-2`

Change the id in your code and config to the vendor's named replacement. The record does not say whether outputs, parameters or prices stay the same, so read the vendor's notice before you switch. Vendor's notice: https://ai.google.dev/gemini-api/docs/deprecations#embedding-models

## Get warned automatically

Upseam is Dependabot for APIs: it watches vendor changelogs and opens a checked pull request when a change affects your code.

Last updated 2026-09-23