---
title: Global Vercel CLI Configuration
product: vercel
url: /docs/project-configuration/global-configuration
canonical_url: "https://vercel.com/docs/project-configuration/global-configuration"
last_updated: 2026-08-25
type: reference
prerequisites:
  - /docs/project-configuration
related:
  - /docs/accounts
  - /docs/cli
  - /docs/cli/telemetry
  - /docs/cli/about-telemetry
summary: Learn how to configure Vercel CLI under your system user.
install_vercel_plugin: npx plugins add vercel/vercel-plugin
search_with_vercel_cli: npx vercel@latest docs search "<query>"
---

# Global Vercel CLI Configuration

Using the following files and configuration options, you can configure [Vercel CLI](/cli) under your system user.


<!-- docsgraph:related -->
## Related pages

> **For AI agents:** Follow these links to understand how this page connects to the rest of the Vercel ecosystem. For the full cross-link map (inbound, outbound, prerequisites, and semantic neighbors), see the .graph.md link below.

- [Vercel CLI Global Options](https://vercel.com/docs/cli/global-options) — Global options are commonly available to use with multiple Vercel CLI commands. Learn about Vercel CLI's global options
- [Using Global Config](https://vercel.com/docs/global-config/using-global-config) — Learn how to use Global Configs in your projects.
- [vercel global-config](https://vercel.com/docs/cli/global-config) — Manage Global Config stores from the Vercel CLI: list, create, inspect, update, delete, and manage items, read tokens, a
- [Get Global Configs](https://vercel.com/docs/rest-api/global-config/get-global-configs) — GET /v1/global-config — Returns all Global Configs.
- [Create a Global Config](https://vercel.com/docs/rest-api/global-config/create-a-global-config) — POST /v1/global-config — Creates a Global Config.

Full cross-link map for this page: [/docs/project-configuration/global-configuration.graph.md](/docs/project-configuration/global-configuration.graph.md)
<!-- /docsgraph:related -->

The two global configuration files are: `config.json` and `auth.json`. These files are stored in the `com.vercel.cli` directory inside [`XDG_DATA_HOME`](https://specifications.freedesktop.org/basedir-spec/basedir-spec-latest.html), which defaults to:

- Linux: `~/.local/share/com.vercel.cli`
- macOS: `~/Library/Application Support/com.vercel.cli`
- Windows: `%APPDATA%\Roaming\xdg.data\com.vercel.cli`

> **💡 Note:** These files are automatically generated by Vercel CLI, and shouldn't need to
> be altered.

## config.json

This file is used for global configuration of Vercel deployments. Vercel CLI uses this file as a way to co-ordinate how deployments should be treated, consistently.

The first options are `// Note` and `// Docs`. They give a description of the file and a link to its documentation, if a user should find themselves looking through it without context.

You can use the following options to configure all Vercel deployments on your system's user profile:

### currentTeam

**Type**: `String`.

**Valid values**: A [team ID](/docs/accounts#find-your-team-id).

This option tells [Vercel CLI](/cli) which context is currently active. If this property exists and contains a team ID, that team is used as the scope for deployments, otherwise if this property does not exist, the user's Hobby team is used.

```json filename="config.json"
{
  "currentTeam": "team_ofwUZockJlL53hINUGCc1ONW"
}
```

### telemetry

**Type**: `Object`.

**Valid values**: An object with an `enabled` property that is `true` (default) or `false`.

This option defines whether [Vercel CLI](/docs/cli) collects telemetry. The [`vercel telemetry`](/docs/cli/telemetry) command sets this value when you run `vercel telemetry enable` or `vercel telemetry disable`. To learn what Vercel CLI collects, see [Telemetry](/docs/cli/about-telemetry).

```json filename="config.json"
{
  "telemetry": {
    "enabled": true
  }
}
```

## auth.json

This file should not be edited manually. It exists to contain the authentication information for the Vercel clients.

In the case that you are uploading your global configuration setup to a potentially insecure destination, we highly recommend ensuring that this file will not be uploaded, as it allows an attacker to gain access to your provider accounts.

## Search the docs from your terminal

Search the Vercel docs and read pages as Markdown with the Vercel CLI. No login required.

```bash
# Find docs pages by keyword
npx vercel@latest docs search "environment variables"
npx vercel@latest docs search "function timeout"

# Print a docs page as Markdown, by path or URL
npx vercel@latest docs inspect <page>
```

---

[View full sitemap](/docs/sitemap)


If you encounter incorrect information, can’t find what you need, need a capability Vercel doesn’t currently offer, or have any other feedback to report, please do it by following the instructions at https://vercel.com/feedback.md.
