FAQs and Troubleshooting

Frequently asked questions

Designer Extensions

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.

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

To share your app beyond your development workspace, you’ll need to publish your app to the Marketplace. However, you can choose to keep your published app private and control who you share it with. To do this, follow the submission guidelines and select the “Private” option on “Marketplace Visibility” section of the submission form. All private apps are reviewed in the same process as public apps by Webflow before they’re published. Learn more about options for publishing your app in the Webflow Marketplace.

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

  • 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.

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.

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.

  • 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.
  • 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.
Built with