How to submit a Hybrid App to Webflow Marketplace? (Designer install vs bundle.zip)

Developers Marketplace Submission
1

Hi Everyone

I’ve built a Hybrid App using the Webflow Designer API, and the app is currently working correctly.

I have a few questions about submitting it to the Webflow Marketplace:

  1. For Designer Apps, we usually submit a bundle.zip.
    For Hybrid Apps, what is the correct way to submit the app for review?

  2. My Hybrid App is currently running on ngrok for development.
    Do I need to deploy the app to a production URL (Vercel / Render / Railway, etc.) before submission?

  3. In the Marketplace submission:

    • What should be the Install URL for a Hybrid App?

    • Should it point directly to the Webflow OAuth URL or to my hosted app URL?

  4. Is it required that the app works without ngrok at the time of review?

Any guidance or official docs around submitting Hybrid Apps to the Marketplace would be really helpful.

Thanks in advance

2

Hey @Shivam_Goud ! Great questions, definitely room for us to improve guidance here.

For hybrid apps, start by filling out the app submission form (mark Hybrid as the app capability)

Our review team needs to create an app listing record on our end first to enable you to submit your bundle. They should get back to you to let you know you can proceed to do this.

You will also need to deploy your hybrid app backend (the service calling your Data APIs and managing users authorizations) to a production URL. You can use whatever service makes sense here, including Webflow Cloud!

For the submission, the Install URL can be two options:

  1. If a user needs to complete authentication into your platform first, you can direct them to your platform, users auth, and then you redirect them to a page to complete Webflow OAuth (this will be the same link as the Install button in your app settings).
  2. OR you can just simply set the Install URL to the Webflow OAuth URL. Read more on this here

If you go with option 1, we just request you make it clear to guide the user as easily as possible to the Webflow OAuth step to make that connection.

And lastly, yes, when you submit your app for review, it should be production-ready without localhost references/local ngrok setup/etc.

Hope this helps!

How to submit Hybrid app
3

Thanks a lot for the guidance — really helpful!