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
- A Webflow account.
- A Webflow Workspace with Admin permissions. Need a workspace? Apply for a free Developer Workspace.
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
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.
Navigate to Workspace settings
From the “settings” menu on the left sidebar, select the “Apps & Integrations” tab. Scroll down to the “App Development” section and click the “Create an App” button. This will open the App creation modal.
Add App details
- 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.
Installation settings (optional)
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.
Define App capabilities
Click the “Continue” button to define your App’s 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.
Data Client: OAuth configuration
If you’ve selected the Data Client capability, you’ll need to configure the scopes and redirect URIs for your App.
- Select the scopes your App needs to function. Learn more about scopes in our short guide.
- 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.
Review your App
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.
Designer Extension: App information
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
Why am I getting an Invalid Redirect URI error?
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
Why can't I see the App Development section?
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.