Learn how to delete a model you no longer need from the Vertex AI Model Registry.
If you want to delete a BigQuery ML from Vertex AI Model Registry, you must first delete it from BigQuery ML. To learn more, see BigQuery ML and Vertex AI Model Registry .
If you want to delete a model that is deployed to an endpoint, you need to undeploy it first. Otherwise, you are unable to delete the model.
Delete a model
Console
-
Go to the Model Registrypage from the Vertex AI section in the Google Cloud console.
-
Select More actionsfrom the model you want to delete.
-
Select Delete model. When you delete the model, all associated model versions and evaluations are deleted from your Google Cloud project.
-
Click Deleteon the confirmation screen.
gcloud
Before using any of the command data below, make the following replacements:
- MODEL_ID : The ID of your model.
- PROJECT_ID : Your Google Cloud project ID .
- LOCATION
: Your project's region. For example,
us-central1.
Execute the following command:
Linux, macOS, or Cloud Shell
gcloud ai models delete MODEL_ID \ --project = PROJECT_ID \ --region = LOCATION
Windows (PowerShell)
gcloud ai models delete MODEL_ID ` --project = PROJECT_ID ` --region = LOCATION
Windows (cmd.exe)
gcloud ai models delete MODEL_ID ^ --project = PROJECT_ID ^ --region = LOCATION
API
Delete a model using the Vertex AI SDK for Python.
Python
Delete a model version
Console
-
Go to the Model Registrypage from the Vertex AI section in the Google Cloud console.
-
Expand the model to view its model versions. Select the version that you want to delete.
-
Select the More actionsfrom the model version. menu .
-
Select Delete version. All associated model evaluations are deleted when you delete your version.
gcloud
Before using any of the command data below, make the following replacements:
- MODEL_VERSION_ID : The ID of the model version to delete.
- PROJECT_ID : Your Google Cloud project ID .
- LOCATION
: Your project's region. For example,
us-central1.
Execute the following command:
Linux, macOS, or Cloud Shell
gcloud ai models delete-version MODEL_VERSION_ID \ --project = PROJECT_ID \ --region = LOCATION
Windows (PowerShell)
gcloud ai models delete-version MODEL_VERSION_ID ` --project = PROJECT_ID ` --region = LOCATION
Windows (cmd.exe)
gcloud ai models delete-version MODEL_VERSION_ID ^ --project = PROJECT_ID ^ --region = LOCATION
API
Python
Delete a model version with the default alias
Console
- From the Model Registry, select the model name to view its model versions.
- Select the version that you want, and from the Actionsbutton click Delete. A warning opens since you're attempting to delete the default alias version. Set another version as default first.
- Select what version you want to make default for the model from the drop-down.
- On the confirmation screen, click Set and delete.

