Configure your Webflow app | Webflow Developer Documentation

The webflow.json file configures your Webflow app, defining how the CLI builds and deploys your code for each product. This file is created automatically when you run init commands, but you can modify it to customize behavior.

File location

Place webflow.json in the root of your app:

my-webflow-project

src

webflow.json

package.json

Schema

The webflow.json supports configuration for:

Region targeting
Code Components
DevLink
Webflow Cloud
Designer Extensions

Each product has its own set of configuration options. See below for the configuration options for each product.

Region

Requires Webflow CLI 2.9.0 or later

Region targeting is available on every release channel, including stable, starting with this version.

Unlike the product-specific options below, region sits at the top level of webflow.json, alongside siteId:

webflow.json

{
  "siteId": "<Your Site ID>",
  "region": "eu"
}

Field	Description	Default	Required
`region`	Webflow region to target: `us` or `eu`.	`us`	No

The CLI resolves the active region in this order, highest priority first:

--region <us|eu> flag
WEBFLOW_REGION environment variable
region in webflow.json
The region you last logged into (persisted in ~/.config/webflow/auth.json, or %APPDATA%\webflow\auth.json on Windows)
us (default)

In a CI/CD pipeline, set the environment variable rather than editing the manifest:

WEBFLOW_REGION=eu webflow sites list

See Production EU authentication for a full login walkthrough.

Code Components

webflow.json

{
    "library": {
        "name": "<Your Library Name>",
        "components": ["./src/**/*.webflow.@(js|jsx|mjs|ts|tsx)"],
        "bundleConfig": "./webpack.webflow.js"
    }
}

Field	Description	Required
`name`	The name of your component library as it appears in Webflow	Yes
`components`	Glob pattern matching your component files. To target a specific folder, use a path like `src/my-components/*/.webflow.tsx`.	Yes
`bundleConfig`	Path to a custom webpack configuration file	No

DevLink

{
  "siteId": "<Your Site ID>",
  "devlink-export": {
    "rootDir": "./webflow",
    "components": ".*",
    "componentGroups": ".*",
    "ts": true,
    "cssScopes": true,
    "relativeHrefRoot": "/"
  }
}

Configuration options

siteId sits at the top of webflow.json; every other option below lives under the devlink-export object.

Option	Description	Default	Required
`siteId`	Webflow site ID	`process.env.WEBFLOW_SITE_ID`	No
`rootDir`	Directory to export components into	`./webflow`	Yes
`cssScopes`	Enable CSS `@scope` wrapping for component styles	`true`	No
`ts`	Generate TypeScript files for exported components	Auto-detected from `tsconfig.json` and `.ts`/`.tsx` files in the project on first export	No
`components`	Regex pattern to match components to export	`.*`	No
`componentGroups`	Regex pattern to match component groups to export	`.*`	No
`relativeHrefRoot`	How relative `href` values are rewritten in exported Link and Image components	`/`	No

DevLink assumes reasonable defaults for most of the settings, but you can specify certain options to customize the behavior of DevLink management and setup. See the DevLink documentation for more details.

Webflow Cloud

{
  "cloud": {
    "app_id": "<Your App ID>",
    "framework": "astro"
  }
}

Field	Description	Required
`app_id`	Cloud app identifier. This is automatically set by the Webflow CLI when you run `webflow cloud deploy`.	Yes
`framework`	Framework preset either `nextjs` or `astro`	Yes

Legacy project_id field

Before this rename, the Webflow CLI wrote a project_id field to webflow.json. The CLI still reads project_id as a fallback, so existing manifests keep working without changes. New deploys always write app_id. A future major release will drop the legacy field — feel free to switch your manifest to app_id whenever you redeploy.

Designer Extensions

{
  "name": "<Your Extension Name>",
  "apiVersion": "2",
  "publicDir": "dist",
  "appIntents": {
    "image": ["manage"],
    "form": ["manage"]
  },
  "appConnections": [
    "myAppImageConnection",
    "myAppFormConnection"
  ]
}

Field	Description	Default	Required
`name`	The name of your extension as it appears in Webflow	-	Yes
`apiVersion`	The API version to use for your extension	`2`	Yes
`publicDir`	The directory to build and serve the extension from	`dist`	Yes
`appIntents`	The element types that can create connections to your extension	`{}`	No
`appConnections`	The element types that can create connections to your extension	`[]`	No