Register an App

To start developing a Webflow App, you’ll first need to register an App to a Webflow Workspace. This guide will walk you through creating and registering your App with Webflow.

Prerequisites

Admin access required

To protect your workspace’s security and maintain compliance, only Workspace admins have privileged access to:

  • Create and configure new Apps
  • View and rotate client secrets
  • Upload App bundles
  • Modify App permissions and details

Register an App

Webflow Dashboard
1

Open the Webflow Dashboard

Login to your Webflow account and navigate to your Dashboard.

2

Choose a Workspace

Select the Workspace for your App. While you can use any workspace, we recommend creating a dedicated development Workspace to keep your Apps organized and separate from production environments.

New to Webflow?

Get started with our free Developer Workspace designed for testing and developing Apps.

4

Add App details

App Details
Here, you’ll add the following basic information for your App:

  • Name: The name of your App
  • Description: A brief summary of your App’s purpose (140 characters max)
  • Icon: An icon to represent your App
  • Homepage URL: A valid HTTPS link to your App’s website

For more details on how your App will appear in the Marketplace, see our App Listing guide.

If you’d prefer to restrict your App’s installation to a specific site, you can configure your App’s installation settings by toggling this option in the modal. This setting allows users to authorize your App for a single site, rather than the default behavior of authorizing it for multiple sites or an entire Workspace.

5

Define App capabilities

Click the “Continue” button to define your App’s capabilities.

App Capabilities

Here, you’ll select the capabilities your App needs to function. You can choose from the following capabilities:

  • Designer Extension: Enables your App to interact with the Webflow Designer.
  • Data Client: Enables your App to access and update data from Webflow’s servers.

You can select one or both of these capabilities. Selecting both will allow your App to interact with both Webflow’s servers and the Webflow Designer as a hybrid app.

If you’ve selected the Data Client capability, you’ll need to configure the scopes and redirect URIs for your App.

  1. Select the scopes your App needs to function. Learn more about scopes in our short guide.
  2. Add a valid redirect URI for the OAuth authorization flow. This URI is where users will be redirected after authorizing your App. Learn more about OAuth and Redirect URIs. You can always update this URI later.

Once you’ve configured your App’s capabilities, click the “Create app” button to complete the registration process.

6

Review your App

App details

Congratulations! You’ve successfully registered your App in Webflow. On successful registration, your App will be displayed in the App Development section. You’ll see key details including the Client ID and Client Secret. From here, you can also update your App’s details, capabilities, and installation settings.

If you’ve selected the Designer Extension capability, you’ll see additional information specific to Designer Extensions:

  • Publish Extension Version: This button will open a modal where you can upload a new version of your Designer Extension and add version notes. For detailed publishing instructions, see our Publishing Designer Extensions guide.

  • Designer Extension URI: The URI where your extension will be served within the Webflow Designer iframe. This URI is important when configuring CORS settings for your extension.

  • Versions: View all previously published versions of your Designer Extension. This helps you track your extension’s version history and rollback if needed.

App Security
  • Never commit your Client Secret to version control
  • Rotate your Client Secret if it’s ever exposed
  • Store secrets in environment variables or a secure secret management system
  • Implement proper CORS policies for Designer Extensions

Troubleshooting

Ensure your redirect URI:

  • Uses HTTPS. If you’re developing locally, consider using ngrok to create a secure tunnel to your local server.
  • Matches exactly what you’ve registered

Verify that:

  • You’re in the correct Workspace
  • You have Admin permissions on the Workspace
  • Your account has been verified and has 2-factor authentication enabled

Next Steps

To see your new App in action, follow these Quickstart guides, which will get your App up and running in Webflow.

Was this page helpful?
Built with