In the Google Cloud CLI, configurations enable you to set properties that
affect the behavior of the active `gcloud` session. A `default` configuration is
created when you initialize Google Cloud CLI and you can create other named
configurations.

A configuration can include default values for specific properties so that you
do not need to specify them in your commands.

For more information about using configurations, see the
[gcloud config](https://docs.cloud.google.com/sdk/gcloud/reference/config) documentation.

## Setting defaults

You can set a default project, repository, and repository location in the
Google Cloud CLI active configuration so that you don't need to include them
in commands where those values are required.

If you do specify a value for a project, repository, or repository location,
that value overrides the configured default. You can do this with the
`--repository` or `--location` flag in your command.

If you're using repository modes other than standard mode, or frequently using repositories in different locations, setting default values might not be helpful.

### Setting a default project

> [!NOTE]
> **Note:** When you set a default project, the setting applies to all `gcloud` commands that include a `--project` flag. The default repository and repository location settings are specific to Artifact Registry commands.

To set default project for all `gcloud` commands, run the command:

    gcloud config set project PROJECT

Replace <var translate="no">PROJECT</var> with the ID of the project or fully qualified
identifier for the project.

To override the default, use the `--project` flag in your command. For example

     gcloud artifacts packages list --project=my-project

### Setting a default repository

To set a default repository, run the command:

    gcloud config set artifacts/repository REPOSITORY

Replace <var translate="no">REPOSITORY</var> with the name of the repository, or fully
qualified identifier for the repository.

To override the default, use the `--repository` flag in your command. For example

    gcloud artifacts packages list --repository=my-repo

### Setting a default location

To set a default repository location, run the command:

    gcloud config set artifacts/location LOCATION


Replace <var translate="no">`LOCATION`</var> with the regional or multi-regional
[location](https://docs.cloud.google.com/artifact-registry/docs/repo-locations) of the repository.

To view a list of supported locations, run the command:

    gcloud artifacts locations list

To override the default, use the `--location` flag in your command. For example

    gcloud artifacts packages list --repository=my-repo --location=us-central1

## Removing default values

When you remove a default value for a configuration property, you must specify
it in `gcloud` commands that require the property.

To unset the default project run the following command:

    gcloud config unset project

To unset the default repository, run the following command:

    gcloud config unset artifacts/repository

To unset the default location, run the following command:

    gcloud config unset artifacts/location