Instructions to Use the Plugin Step 1 — Add the Element

Drag Batchy Runner onto your page

It’s an invisible logic element (no UI)

Step 2 — Configure Element Properties (once)

Set these on the element:

Items per batch → e.g. 100

Delay between batches (ms) → e.g. 500 or 1000

Max retries → e.g. 3

Stop on error → yes/no

Debug logs → yes (recommended while testing)

These settings control how the batch execution behaves.

Step 3 — Create the Workflow

Add a workflow action:

Batchy Runner → Start Batch

Fill the inputs:

Items list
A list of texts (IDs, emails, slugs, etc.)

API URL
The endpoint you want to call

HTTP Method
GET / POST / PUT / PATCH

Headers (optional)
Example:
Authorization : Bearer YOUR_TOKEN

Body template
A JSON body that must include {{batch}}

Example:

{ "items": {{batch}} }


⚠️ Important:
Do not put quotes around {{batch}}. It is replaced with a JSON array automatically.

Step 4 — (Optional) Show Progress in the UI

You can bind UI elements to exposed states:

is_running → disable buttons

current_batch / total_batches → status text

progress_percent → progress bar

last_response → debug / inspection text

Example:

Processing batch Current batch / Total batches

Step 5 — React to Events

You can trigger workflows when:

Batch Started → initialize UI

Batch Success → log progress

Batch Error → show error / notify

Batch Finished → show “Done” message

Step 6 — Stop Execution (Optional)

Use the action:

Batchy Runner → Stop Batch

This immediately stops further processing.

✅ Typical Use Cases:

Processing 60,000+ records through APIs limited to 100 items

Bulk imports or exports

Syncing data with external services

Updating statuses in bulk

Webhook-style fire-and-forget APIs

Run mode:
https://testlpu.bubbleapps.io/version-test/batchy_runner

editor:
https://bubble.io/page?id=testlpu&test_plugin=1768939123280x916330785791803400_current&tab=Design&name=batchy_runner&type=page&elements=cmtTk