> This page is for Home.

> For clean Markdown of any page, append .md to the page URL.
> For a complete documentation index, see https://developers.webflow.com/llms.txt.
> For AI client integration (Claude Code, Cursor, etc.), connect to the MCP server at https://developers.webflow.com/_mcp/server.

# v2.5.0: Global telemetry configuration and a code component crash fix

> webflow auth telemetry now writes global configuration by default, with a new --local flag for the old per-project behavior. @webflow/react also fixes a crash when a page combines code components built against different React major versions.

v2.5.0 changes where telemetry preferences are stored and fixes a crash affecting sites that combine code components from different sources.

### Global telemetry configuration

`webflow auth telemetry --enable/--disable` now writes to a global config file (`~/.config/webflow/telemetry.json` on macOS/Linux, `%APPDATA%\webflow\telemetry.json` on Windows) instead of the current project's `webflow.json`. Bare CLI invocations in a project without a manifest no longer create one just to record a telemetry preference.

A new `--local` flag opts back into the previous behavior for teams that want a per-project override:

```bash
webflow auth telemetry --disable --local
```

A `webflow.json` that already has a telemetry setting continues to be read and takes precedence over the global config for commands run in that directory. `DO_NOT_TRACK` continues to override everything.

### Fix: crash when combining code components from different sources

Fixed a crash — `Element type is invalid: expected a string ... but got: object` — that could occur when a published page loaded code components built against different React major versions. Upgrade `@webflow/react` to `2.1.1` and re-bundle libraries to pick up the fix.

### Also in this release

* Patched transitive `brace-expansion` and PostCSS dependencies addressing known vulnerabilities.
* `webflow cloud deploy` can now resolve its framework builder from a shared `@webflow/app` package when enabled server-side; the local `COSMIC_BUILD_ENGINE=v2|legacy` environment variable can override the selection for a single run.

## Upgrading

```bash
npm install -g @webflow/webflow-cli@latest
```