Introduction to the Webflow CLI

The Webflow CLI brings Webflow development into your local environment, allowing you to use your own tools, workflows, and version control. Use the CLI to manage sites, CMS content, forms, and assets, build and share code components, manage Webflow Cloud deployments, and sync code with your Webflow sites directly from the command line.

With the CLI, you can:

Manage Sites

List, inspect, and publish Webflow sites without leaving the terminal.

Manage Assets

Upload, update, and organize site assets and folders from the command line.

Manage CMS Content

Create, read, update, and publish CMS collections, fields, and items via the API.

Manage Forms

List forms and export submissions to JSON or CSV from the command line.

Authenticate

Log in once and manage your session across all CLI commands with auth login, auth status, and auth logout.

Share Code Components

Create reusable React components and deploy them directly to the Webflow Designer.

Export components with DevLink

Export your Webflow Components as a self-contained local React bundle.

Deploy to Webflow Cloud

Host and manage full-stack applications with serverless functions, data storage, and dynamic routing.

Create Designer Extensions

Develop custom applications that run directly inside the Webflow Designer.

Installation

The Webflow CLI requires Node.js 22.13.0 or higher.

Install the Webflow CLI globally using npm:

npm install -g @webflow/webflow-cli

Verify the installation:

webflow --version

Authentication

Authentication connects your Webflow account to the CLI, enabling you to deploy and sync code with Webflow.

webflow auth login

This opens your browser to authenticate with a workspace. After you grant access, the CLI stores a WEBFLOW_API_TOKEN in your project’s .env file for future commands. For more information, see the authentication documentation.

Configuration

The webflow.json file is used to configure the CLI and should always be in the root of your app. Here you’ll define your app type, and the configuration for each product you’re using.

Below is an example of a webflow.json file for an app that uses Code Components, DevLink, and Webflow Cloud. To see more on configuration, see the configuration documentation.

{
  "siteId": "<Your Site ID>",
  "cloud": {
    "app_id": "<Your App ID>",
    "framework": "astro"
  },
  "devlink-export": {
    "rootDir": "./webflow",
    "components": ".*",
    "componentGroups": ".*",
    "ts": true,
    "cssScopes": true,
    "relativeHrefRoot": "/"
  },
  "extensions": {
    "name": "<Your Extension Name>",
    "apiVersion": "2",
    "publicDir": "dist"
  },
  "library": {
    "name": "<Your Library Name>",
    "components": ["./src/**/*.webflow.@(js|jsx|mjs|ts|tsx)"],
    "bundleConfig": "./webpack.webflow.js"
  }
}

Commands

The CLI is organized by command group:

Use --help with any command to see available options:

webflow devlink --help

For more information on each command, see the command reference.