Product

Learn about the product requirements for listing an app in the marketplace

Your app must meet the following product requirements to receive approval for the app marketplace:

  1. Create at least one app feature (read more here) with a description in the Developer Center. Make sure that your app has a clear use case that your feature can solve.
  2. Ensure that your app works with different user types, including member, admin, guest, and viewer. The app should show relevant messages to each user type (e.g., viewers can't access the API, so your app should display a relevant message like As a viewer, you are unable to use this app.). We pass an isViewOnly parameter in the sessionToken that you can decode to check if the user is view-only.
  3. Your app must:
    1. Support small and large boards (use techniques like pagination, infinite scroll, and bulk operations to do so - read more on rate limiting here)
    2. Support multiple columns of the same type
    3. Work on public, private, and shareable boards
    4. Work in different monday accounts that share the same email
  4. If your app has more than one feature, set your starting point.
  5. Provide a valid installation link. You can find your installation link under Developers > Your app > Share > Share your app with others. The link should follow this format: https://auth.monday.com/oauth2/authorize?client_id=*******
  6. If your app redirects users to a sign-in or authorization page, you must redirect them back to monday upon completion.
  7. Implement the value-created event method in your code.
  8. Embed a guidance video or link to your How-to-use page in the app.
  9. Make sure users can set up your app without consulting documentation.
    1. For views, provide in-app onboarding to accommodate no-touch configuration (if required). You should be able to describe the main flow in 3-5 steps.
    2. For integration recipes, provide a clear and descriptive recipe sentence.
  10. For workspace templates, ensure that the other app features can be added to boards independently with clear onboarding guidelines or added a clear message to users (e.g., To use this app the best way, please use the Workspace Template.).
  11. For workspace templates, the attached images should be descriptive, look good, not be broken, and be 1424x779 pixels in size. You can set this under Developers > App > Workspace Template > Feature Details.
  12. For workspace templates, create a how-to-use monday doc as part of the template.
  13. Uninstall and reinstall your app to verify that users who previously downloaded the app have the same experience.
  14. Submit a full app URL from the Basic Information page in the Developer Center.

📘

Join our developer community!

We've created a community specifically for our devs where you can search through previous topics to find solutions, ask new questions, hear about new features and updates, and learn tips and tricks from other devs. Come join in on the fun! 😎