Red Center Studio
Knowledge base

Bubble® errors, explained and fixed.

API Connector timeout: "Raw error for the API ESOCKETTIMEDOUT"

The external API did not answer before the API Connector gave up waiting. Make the slow work asynchronous: let the API call you back through a webhook, or split the job into smaller scheduled backend workflows so no single call or workflow runs long.

Read the fix

API Connector call will not initialize

Every API Connector call must be initialized successfully before you can use it. When initialization fails, the request itself is usually wrong or the response is not something the connector can read. Test the request outside Bubble, fix the auth and body, re-initialize, or define the response manually.

Read the fix

Search returns nothing: privacy rules hiding results

A search only returns records the current user is allowed to find, so privacy rules can quietly make results look empty or short. Test as the affected user with Run as, then fix the rule that grants access. In 2026 Bubble also added search privacy constraints, which can change results for searches that filter on protected fields.

Read the fix

Workload unit spikes from nested searches

A search inside each row of a repeating group runs once per row, so one page load can trigger hundreds of searches. Find the expression in App metrics, then replace per-row searches with stored values, constraints instead of :filtered, and counts instead of full lists.

Read the fix

Broken expressions after deleting a field or data type

Deleting a field or data type can leave expressions pointing at something that no longer exists, and the Issue Checker may not flag every case. Find every reference, then either restore the field or rewire the references, and test in development before deploying.

Read the fix

Recursive backend workflow stuck in a loop

A backend workflow that schedules itself without a working stop condition can run indefinitely and burn workload units. Pause or cancel it in the Scheduler, fix the terminating condition, and confirm Infinite Recursion Protection is enabled as a backstop.

Read the fix