How to Configure Your Bubble Plugin for Marketplace Visibility and Licensing
When managing your plugin in the Bubble marketplace, ensuring it is configured correctly for visibility, licensing, and pricing is essential. This article provides step-by-step guidance to address common user concerns related to plugin classification and visibility.
Setting Plugin Licensing and Pricing
If your plugin is marked as 'Testing' instead of 'Free' in the plugin gallery, or if it displays a monthly price when intended to be free, follow these steps to adjust the licensing:
In the Plugin Editor, verify the selected licensing configuration. Ensure the license is set to Open Source if the plugin is meant to be free.
For plugins released under the MIT license, contact Bubble Support to update the configuration.
Changing a plugin license from Commercial to Open Source (or changing its pricing to free) is irreversible. Carefully consider this action before proceeding.
Ensuring Plugin Availability in the Marketplace
Plugins not visible in the marketplace often require proper submission and licensing. To ensure your plugin appears correctly:
Submit the Plugin for Approval - In the Plugin Editor, go to the Settings tab. - Select the appropriate "Plugin distribution license" from the dropdown. - Click "Submit a new version" to publish. A demo link showcasing your plugin’s functionality is required as part of the submission process.
Create a Useful Demo Application - The demo app should include all features listed in your plugin's description. - Ensure its design is clean and easy to navigate. - Provide a button in the demo app to access it in the Bubble editor. - Set the app's rights to "Everyone can view" under Settings → General.
What is a Run-Mode URL?
A run-mode URL is a link to a live, functional Bubble page that showcases your plugin in action. This page should be accessible to anyone without requiring editor access and should clearly demonstrate the features and functionality of your plugin.
Steps to Generate a Run-Mode URL
To create a run-mode URL for your Bubble demo app, follow these steps:
Open your demo app in the Bubble editor.
Navigate to the app’s privacy settings (Settings → General) and ensure the setting is configured to "Everyone can view."
Use the preview/run-mode link that loads the app as end-users would see it. Avoid using the editor URL.
Include this run-mode link in your plugin submission.
Guidelines for Demo Page Content
The demo page linked via the run-mode URL should:
Contain a working URL to a Bubble page in run mode.
Publicly demonstrate your plugin’s features without requiring editor access.
Showcase the plugin functioning as described in your submission.
Completion of these steps will enable potential users to explore and understand your plugin before installing it.
Best Practices for Demo Applications
Add a button on the demo page that links to the app’s editor. This allows users to explore the setup and better understand how the plugin works.
Ensure the demo page is clean, functional, and accurately represents the plugin’s features.
If using a documentation page as the run-mode link, ensure it demonstrates the plugin’s functionality and include the editor's link for the review process.
Diagnosing Plugin Visibility Errors
If your plugin page redirects to the marketplace rather than displaying the plugin-specific page, the issue may stem from incomplete required fields or inactive status.
To address this:
Check that all required fields, including Description, Instructions, and Demo page, are completed.
Verify that your Seller Profile is set to ACTIVE.
Confirm the plugin status in the Live Meta DB using the plugin's unique ID, available in the plugin page URL or editor URL.
These steps will help resolve redirection issues and ensure proper plugin visibility.
Summary
Proper configuration and submission are crucial for maximizing your plugin's visibility and functionality in the Bubble marketplace. By ensuring correct licensing, submitting required fields, and providing a thorough demo, you can align with best practices and offer a seamless user experience. For further issues or advanced topics, refer to Bubble’s documentation or contact their support team for assistance.