Logo
Logo

Troubleshooting Errors

When Breakdance throws an error, the most reliable way to fix it fast is to reproduce the problem, gather the right logs, and loop in your web host (or us). This guide walks you through that process. It also shows how to capture errors easily with WP Debug Toolkit (our partner tool).

Start Here: Quick Troubleshooting Flow

  • Reproduce the issue and note the exact time (include timezone), what page you were on, and the steps you took.
  • Clear caches: page cache, server cache/OPcache, and CDN (e.g. Cloudflare).
  • Conflict test: temporarily disable all plugins except Breakdance. If the issue disappears, re-enable items one by one to find the culprit. This should be done in a staging copy of your site.
  • Check resources: make sure you’re on a recent PHP version (8.1+ is recommended) and that your site has enough resources allocated.
  • Staging first: if possible, reproduce on a staging site so you can test safely.

Server Timeouts & Hard Limits

Hosts often enforce limits that terminate long-running processes. Two common examples:

  • Maximum Execution Time (PHP): Set via max_execution_time in php.ini. Increasing this is a last resort.
  • FCGID Timeouts (Apache): FcgidIOTimeout governs how long mod_fcgid waits on reads/writes. In many environments, ~90 seconds is sufficient.

If you consistently hit timeouts, contact your host to review and raise these limits as appropriate.

HTTP 500/50x Errors

500-level responses usually indicate a server or PHP error, or an overloaded environment. For detailed, Breakdance-specific guidance, see our article:

Troubleshooting 500/50x Errors

HTTP 403 (Forbidden) Errors

403s are commonly caused by security layers (WAF, ModSecurity, firewall, CDN rules) blocking legitimate requests. See:

Troubleshooting 403 Errors

Server Errors (500, 503, 504, 524, etc.)

Servers throw numeric error codes when misconfigured or overloaded. A few common ones:

  • 500 Internal Server Error: Often a PHP error or a conflict in a theme/plugin.
  • 503 Service Unavailable: Server/stack is overloaded, or a security system is blocking requests.
  • 504 Gateway Timeout: Upstream timeout, usually due to load or slow scripts.
  • 524 A Timeout Occurred: Cloudflare reached your origin but didn’t get a response within its timeout.

Breakdance Support can’t fix server configuration problems directly. Your host must locate and resolve the underlying issue, which requires the server logs.

Check Your Server’s Error Logs

To find what’s wrong, check your server error logs and look for possible errors that appear and could be related to the problem. The simplest way to do this is to use our partner tool WP Debug Toolkit, which is gonna display all errors from your server, and you can get it at a discount using the code BDDOC.

If you’re unable to find these errors logs yourself, your host should examine the server’s error logs for entries at the time the error occurred. To help them help you, include the following data when reaching out to your web host support team:

  • Approximate time of the error (with timezone). If unsure, reproduce the error and note the time.
  • Your IP address (visit whatismyip.com to obtain it).
  • A screenshot of the error, including the full URL in the browser.
  • Exact steps to reproduce (click-by-click).

“There’s nothing in the logs.”

If errors are happening but your host can’t find entries, ask them to ensure logging is enabled and that they’re checking the right places. Errors are typically logged at least in:

  • PHP error logs
  • Web server logs (Apache, NGINX)
  • Database logs (MySQL, MariaDB)

If needed, try a different support channel (phone/chat) or ask to be escalated to a higher support tier.

Once you’ve obtianed the error logs, send us the relevant error logs entries via our support channels and we’ll assist you troubleshoot and fix the error.

Enable WordPress Debugging (if your host can’t help)

If your host can’t provide server logs, and WP Debug Toolkit isn’t an option, enable WordPress’s built-in debugging to capture PHP errors. After enabling, reproduce the issue and share the entries from the time it occurred. Note: many logs are in UTC. You can compare time zones at everytimezone.com.

See the official guide: Debugging in WordPress.

// Add (or update) in wp-config.php above "/* That's all, stop editing! */" define( 'WP_DEBUG', true ); 
define( 'WP_DEBUG_LOG', true ); // writes to wp-content/debug.log 
define( 'WP_DEBUG_DISPLAY', false ); // keep errors off the front-end @ini_set( 'display_errors', 0 );

After reproducing the issue, download wp-content/debug.log and share the relevant lines (around the time of the error).

FTP/SFTP Access (If Requested)

Sometimes your developer will request temporary file access to diagnose and fix issues.

  • Ask your host to create a temporary SFTP user limited to your site’s directory.
  • Collect: host, port, username, password (or SSH key), and the root path.
  • Test the login yourself (e.g., with FileZilla) before sharing.
  • Share credentials over a secure channel and delete the user once the issue is resolved.

What to Include When You Contact Breakdance Support

  • Exact steps to reproduce (include URLs).
  • When it happened (include timezone) and your IP address.
  • Screenshots or a short screen recording of the issue.
  • Relevant error log entries from WP Debug Toolkit or your host.
  • Environment: WordPress version, Breakdance version, PHP version.
  • Active plugins list (and the result of your conflict test).

Submit everything at breakdance.com/support/. The more precise your details, the faster we can help.

Important Notes

  • Breakdance Support can’t fix server configuration; your host must resolve server-level errors. That’s what you pay hosting for, and a good host will read and act on server logs.
  • If your host can’t find errors, ask them to verify logging is enabled and check PHP, web server, and database logs.
  • If you get stuck at any step above, tell us exactly where you’re blocked, and we’ll assist you. Communication helps us help you faster.

About WP Debug Toolkit

WP Debug Toolkit is a simple way to surface hidden PHP/WordPress errors and gather the exact logs our team needs.

  • Install & activate WP Debug Toolkit.
  • Enable its error capture features.
  • Reproduce the issue.
  • Export/copy the errors it reports and share those specific entries with Breakdance Support.

We’ve partnered with them to offer a discount; use code BDDOC.

Meet Breakdance: The Best Visual Builder for WordPress
faces
Join thousands of freelancers and agencies who are working better and faster using Breakdance