Created to upload JSON to Bubble with greater ease, speed, and WU savings compared to traditional workflows. Configure in minutes.

JSON UPLOADER is a server-side plugin that processes data uploads in Bubble. It receives, optimizes, and uploads data directly into the Bubble database using the Data API — Bubble’s most efficient data engine.

This setup delivers significantly faster performance and substantially better WU efficiency, well beyond what conventional workflows can efficiently achieve.

Perfect for: data imports, migrations, synchronizations, and bulk operations — from dozens to thousands of records.

Recommended for developers handling small to large data volumes, and teams prioritizing performance, speed, and WU optimization.

Not recommended for: update or delete workflows.



📊 WHY USE THE DATA API FOR UPLOADS?

Bubble’s Data API was designed for high-performance CRUD operations.
Although commonly used for external integrations, it is equally powerful for internal bulk uploads, offering:

• Higher speed
• Stable execution
• Significant savings in WU (Workflow Units)

🛡️ Stability and Guaranteed Execution

Runs entirely on the backend and completes execution even if the browser closes, the connection drops, or the user leaves — ensuring reliable migrations and syncs.



🚀 HOW JSON UPLOADER WORKS

The JSON UPLOADER | Data API Import is triggered by a FRONT-END WORKFLOW, but all processing happens exclusively on the server (back-end).

Once triggered, execution continues even if:
• The browser is closed
• The connection is lost
• The user exits the app

This guarantees speed, economy, and stability for critical scenarios such as data migrations and synchronizations.



▶️ LEARN MORE ABOUT SETUP AND TESTING AT:

https://json-uploader-demonstration.bubbleapps.io/version-test



⚙️ HOW TO CONFIGURE THE JSON UPLOADER (5 STEPS)

Follow these 5 steps to install and use the plugin:

1️⃣ Enable the Data API
2️⃣ Enter the API Key on the plugin page
3️⃣ In the workflow action: enter the JSON
4️⃣ In the workflow action: enter the Data Type
5️⃣ In the workflow action: select This URL

Install the plugin and add it to a front-end workflow.


🔧 WORKFLOW CONFIGURATION (3 FIELDS)



1️⃣ — JSON DATA (In the plugin action (workflow)
┌──────────┐
│                              ◄── Paste your JSON records here
└──────────┘


Paste the JSON records that will be sent to the database.
The content can come from a multi-line input, a custom state, or any dynamic text that outputs valid JSON.


2️⃣ — DATA TYPE (In the plugin action (workflow)
┌──────────┐
│                              ◄── Enter the table name (Data Type)
└──────────┘

Enter the name of the table (Data Type) that will receive the records.  
You can type it manually or copy the Data Type name from the database and paste it into the field.  
The name must be exactly the same as the Data Type created in Bubble.


3️⃣ — THIS URL (In the plugin action (workflow)
┌──────────┐
│                              ◄── Select “This URL” from the dropdown menu
└──────────┘

In the This URL field, select the This URL option from the dropdown.  
This option usually appears at the end of the list.


4️⃣ — API KEY

Enter your Private Key on the plugin’s settings page in your Bubble app.
 
You can paste the key directly, or click Enter your API key in the workflow to be redirected to the Plugins page.

To obtain the key, go to Settings → API, copy your Data API Key from the Private keys section, and paste it into the plugin field.


5️⃣ — ENABLE DATA API

⚠️ To allow records to be sent, the Bubble Data API must be enabled.

Follow these steps:  
a) In the Bubble editor, go to Settings → API  
b) Enable or confirm that the Enable Data API option is turned on  
c) Check the Data Types that will receive the records



🧩 PLUGIN CONFIGURATION, TESTS & LOGS

Understand the plugin setup in more detail by visiting the demo page.
There you’ll find the full configuration, visual examples, and test logs to help you validate the integration.



👉 https://json-uploader-demonstration.bubbleapps.io/version-test



Any questions about JSON UPLOADER?

We're here to help.


Devs Premium

📧 [email protected]