# Switch model provider

Switching replaces the workspace's [model provider](https://docs.faustine.ai/workspace/model-providers/) with another one. Analysis, the Advanced editor and chat run on the new provider as soon as you save.

## Before you begin

- More than one provider is enabled for your workspace. **Switch provider** is not shown when a single provider is set for the workspace.
- You have the credentials for the new provider. See the page for that provider under [Model providers](https://docs.faustine.ai/workspace/model-providers/#providers).

## What a switch discards

| Part | What happens on save |
| --- | --- |
| Credentials of the previous provider | Deleted. To switch back you enter them again. |
| Model mapping | Cleared. IDs on one provider mean nothing on another, so you map the models again. |
| Embeddings | The stored key is not carried over, and the **Embeddings** step starts on **Not configured** unless the new provider is LiteLLM or Vercel AI Gateway. Saving it that way turns knowledge off. |

Nothing changes until you save. **Cancel** at any step leaves the previous provider in place.

## Switch provider

To switch:

1. In the portal, go to **Settings** > [**Model Provider**](https://auth.faustine.ai/go?to=%2Fsettings%3Ftab%3Dprovider).
2. Select **Switch provider**. The **Provider** step opens with the previous provider marked **current**.
3. Select the new provider.
4. In **Credentials**, enter the values for the new provider and select **Continue**.
5. If the provider has a **Models** step, enter the model IDs, select **Test connection**, and select **Continue**.
6. In **Embeddings**, select an option and enter its key, then select **Continue**.
7. In **Review & save**, select **Test connection**.
8. Select **Save changes**.

The card shows the new provider with an **Active** badge.

The model mapping is also cleared when you change the **Endpoint** of Amazon Bedrock between `invoke` and `mantle`, because the two endpoints use different model IDs.

## Troubleshooting

| Symptom | Cause | Fix |
| --- | --- | --- |
| There is no **Switch provider** button | One provider is enabled for the workspace. | Contact Faustine to enable another provider. |
| The **Embeddings** row shows **Not configured** after the switch | The previous embeddings option does not exist on the new provider, or its key was not entered again. | Select **Edit** in the **Embeddings** row. See [Choose an embeddings provider](https://docs.faustine.ai/workspace/embeddings/). |

## Next steps

- [Choose an embeddings provider](https://docs.faustine.ai/workspace/embeddings/): the options for the new provider.
- [Choose the chat model](https://docs.faustine.ai/web-agents/chat-model/): check which model each agent uses on the new provider.
- [Usage](https://docs.faustine.ai/workspace/usage/): see the tokens consumed on each model.