FAQs and Troubleshooting
Frequently asked questions
Designer Extensions
What frameworks and libraries can I use to build my Designer Extension?
You can use any framework to build your extension as long as the output can run in a browser environment, outputs static resources, and fits within the iframe dimensions provided by Webflow.
How can I test my Designer Extension?
You can test your Designer Extension by running the extension in development mode. First, make sure you have a test site with the extension installed. Then, run the extension in development mode using the Webflow CLI command webflow extension serve
. This will run the app on your local machine using port 1337. On your test site, you can open the app and click the “Launch Development App” button to see the app in action.
Marketplace apps
Can I update my app after it's been published?
Yes, you can submit updates for your app at any time. Updates will go through the same review process as the initial submission. Use the “Submit an App” form and choose “App Update” in the “Submission Type” dropdown.
Troubleshooting
My App isn't showing up in Webflow.
- Ensure that you’ve correctly bundled your app via the Webflow CLI, and uploaded your Designer Extension via the Webflow Dashboard.
- Make sure you’ve installed the app to your project. You can do this in the App Development section of your workspace.
I can't view/update my app credentials including the Client Secret.
Only Workspace admins have the permissions to view client secret keys, edit app details, and create new apps. This security measure ensures that Workspace owners and admins maintain proper control over access permissions, application configurations, and bundle deployments. If you’re unable to access these credentials, verify that you have Workspace admin privileges. If you don’t have admin access, please contact your Workspace administrator to request the necessary credentials or to perform the required actions on your behalf.
I can't upload a new version of my Designer Extension Bundle.
Only Workspace admins have permission to upload new bundles to Webflow. If you’re unable to upload a new bundle, verify that you have Workspace admin privileges. If you don’t have admin access, please contact your Workspace administrator to upload the bundle for you or to grant you the necessary permissions.
My App isn't interacting with Webflow as expected.
- Double-check your use of the Webflow Designer APIs. Make sure you’re correctly implementing methods for creating and modifying elements. Be sure to check the browser console for any errors and follow our error handling guidelines.
- Be aware that the Designer APIs only allow access to content that’s on the current page of the Designer, not to any other sites, pages, or components that don’t belong to the site.
- Verify that your app has the appropriate permissions and scopes configured in your app registration.
- For Data API issues, ensure you’re using the correct endpoints and properly handling authentication with valid tokens.
My app looks different in Webflow than I expected.
- Designer Extensions run in an iframe with dimensions controlled by your App’s configuration settings or dynamically adjusted using the resizing methods in the Designer APIs.
- Review your CSS implementation to ensure there are no style conflicts with Webflow’s native styling. Consider using scoped CSS or namespacing to prevent unintended style inheritance.
- Test your extension at different viewport sizes to ensure responsive behavior works as expected within the Webflow Designer environment.