Brickser
Get LTD Access
Search Documentation
Search through all documentation pages

Common Issues

Common Issues

If something is not working, check this page first. Most problems fall into one of a handful of patterns.

"Bricks Builder is required" admin notice

Cause: The Bricks Builder theme is not installed or not active.

Fix:

  1. Install Bricks Builder from the official site.
  2. In Appearance → Themes, activate Bricks (or a child theme of Bricks).
  3. Reload the page or open the Bricks editor.

Brickser AI will not load until Bricks is active.

Sparkle icon not showing

There are two sparkle icons in Brickser AI — one in the WordPress admin toolbar (top bar) that launches the Bricks editor, and one in the Bricks editor toolbar next to + Elements that opens the sidebar. If either is missing:

Causes (in order of likelihood):

  1. License is not active. Open the Brickser AI sidebar in Bricks, paste your license key, and click Activate.
  2. Browser cached the old editor JS. Hard-reload (Cmd/Ctrl+Shift+R).
  3. Bricks version too old. Update Bricks to a recent version — Brickser AI depends on the current toolbar structure.
  4. Another plugin is injecting into the same toolbar slot and breaking the DOM. Temporarily deactivate other Bricks-extension plugins to isolate.

If the icon still does not appear, open the browser console with the editor open and look for errors prefixed [Brickser].

License activation fails

Common causes:

  • The key has been activated on the maximum number of sites your plan allows. Deactivate it on a site you no longer use from your Customer Dashboard.
  • The site URL contains a port or non-standard scheme that the licensing server cannot reach. Make sure home_url() resolves to a public URL.
  • A security plugin is blocking outbound HTTPS. Whitelist *.brickserio.workers.dev.

AI provider key not working

Brickser AI is BYOK — generation runs against your own Anthropic, Google Gemini, or OpenAI account. If generation fails the moment you click Generate:

Common causes:

  • The API key is invalid, revoked, or copied with extra whitespace. Re-paste from your provider's console.
  • Your provider account is out of credit or has hit a spend cap. Check usage in the provider dashboard.
  • The key does not have access to the model in use. Some providers gate higher-end models (used for the Thinking tier) behind paid plans — confirm your account has access.
  • A security plugin is blocking outbound HTTPS to the provider. Whitelist api.anthropic.com, generativelanguage.googleapis.com, or api.openai.com depending on your provider.

You can swap providers anytime from the Brickser AI sidebar.

Generation hangs or times out

Causes:

  • Slow connection or unstable network.
  • Server-side PHP timeout on shared hosting (default 30s is sometimes too short).
  • Provider-side rate limiting.

Fix:

  1. Try a single short page first to confirm the connection works.
  2. Ask your host (or set in php.ini) to raise max_execution_time to at least 120s.
  3. Switch the model tier to Default if you were on Thinking — Thinking takes longer and can exceed shared-host timeouts.
  4. Wait a minute and retry if you suspect provider rate limiting.

Required Bricks settings not enabled

If sections insert oddly, the structure panel does not follow your edits, or the builder feels inconsistent, it usually means a required Bricks setting is off. In Bricks → Settings, confirm all three are on:

  • General → SVG uploads (for admins)
  • Builder → Structure panel → Expand active element & scroll into view
  • Custom Code → Code execution

See Installation, Step 6 for the full setup.

Styles not applying on the frontend

Causes:

  • A page caching plugin is serving an old HTML snapshot.
  • A theme stylesheet is loading after Brickser AI's CSS with higher specificity.

Fix:

  1. Clear all caches: page cache, object cache, CDN, browser.
  2. View source on the frontend and confirm a <style> block with --clr-* variables is present in <head>.
  3. If your theme is overriding, scope your overrides via the --clr-* variables instead of fighting with !important.

Project is missing or "Create your project" appears again

Each site has one Brickser project, stored as a WordPress option. If the option was wiped (database reset, restore from a partial backup, plugin re-install with delete), Brickser AI will prompt you to create a new project.

To recover:

  • If you have a previous export file, use Import in the sidebar to restore everything in one go — sitemap, styles, classes, variables, palette, and content.
  • If not, you will need to recreate the project. Pages already in Bricks are not lost — only the Brickser-side metadata.
Tip

Export your project after any significant change. The export is a single file you can keep in version control or back up like any other asset.

Still stuck

Open the Brickser AI sidebar and use the Help → Contact support link, or email support directly. Include:

  • Your WordPress version
  • Your Bricks Builder version
  • Your Brickser AI plugin version (visible on the Plugins screen)
  • The AI provider you're using (Anthropic / Gemini / OpenAI)
  • A short description of what you tried and what happened
Warning

Do not paste your license key or AI provider API key in a public forum or screenshot. Support never needs the full key — they can identify your account from your email.