Skip to main content

How can I import a JSON file into Bubble, and what are the limitations?

Sofia Maconi avatar
Written by Sofia Maconi
Updated over 2 weeks ago

How can I import a JSON file into Bubble, and what are the limitations?

Introduction

Importing a JSON project file into Bubble is a key feature that allows users to transfer applications or updates across Bubble accounts. This article will provide a step-by-step guide, prerequisites for importing, notes on potential risks, and details about limitations and post-import editing capabilities.


Prerequisites for Importing JSON Files

  • Paid Plan Required: The ability to import and export applications in JSON format is available only to users on paid Bubble plans. Users on the Free plan cannot access these features.

  • Existing App: You need an existing Bubble application to import a JSON file into. The process will overwrite the data in the current app or version.


Steps to Import a JSON File

  1. Open your Bubble app editor.

  2. Navigate to Settings → General.

  3. Select the "Import Application" option.

  4. Upload the desired JSON file from your local directory.

Important Notes:

  • Overwriting Content: Importing will overwrite the current version of your app with the uploaded file. It is highly recommended to create a Save Point in Bubble to ensure you can revert back if needed.

  • Primary Use: This feature is mainly intended for transferring applications between different Bubble accounts.


Post-Import Editing

  • Manual Editing: Once a JSON file has been imported, you can manually edit the app using Bubble's visual editor. This includes adding new features, adjusting the design, or updating workflows.

  • No AI Editing: Bubble does not currently support iterative post-import edits using artificial intelligence. Any updates must be made directly by the user within the editor.


Limitations of JSON Import

  1. Free Plan Restriction: Users on the Free plan cannot use the JSON import/export capabilities. Upgrading to a paid plan is necessary.

  2. Overwriting All Data: The import process replaces all content in the current app or version with the imported file’s data, requiring caution.

  3. No Iterative Edits via AI: All changes post-import must be made through the manual editor.


Conclusion

Importing a JSON file into Bubble is a powerful feature, especially for app transfers and updates. However, it is essential to meet the prerequisites (paid plan, existing app), create a Save Point to mitigate data loss, and understand the limitations such as the inability to use AI for changes post-import. By following the outlined steps and precautions, you can efficiently manage your import process and make necessary adjustments after the import is complete. For further details, refer to Bubble’s official documentation on JSON handling.

Did this answer your question?