Skip to main content

09. Troubleshooting

Fixes for the most common issues, roughly in the order they tend to appear.

The modules don't appear in Beaver Builder​

  • Confirm Beaver Builder is installed and active. The modules only register when it is.
  • In the content panel, set the Group dropdown to Beaver Profile Builder; the modules may be filtered out of the current view.
  • Check your plugin version under Plugins: version 1.0.1 had a bug that stopped the modules from loading. Update to 1.0.2 or later.

PHP warnings mentioning "Undefined property" or "config on null" on activation​

This is the 1.0.1 module-loading bug. Update to Beaver Profile Builder 1.0.2 or later, where it is fixed. The warnings are gone after updating; no other action is needed.

Avatar uploads don't save​

  • Confirm the free Simple Local Avatars plugin is installed and active. The Avatar Edit module stores images through it.
  • Confirm you are testing while logged in; the module acts on the logged-in user.

The avatar popup opens but the crop tool doesn't load​

The crop tool is loaded from a public CDN. Content blockers or a strict Content Security Policy that blocks third-party scripts can prevent it from loading. Test in a browser without blocking extensions to confirm, then allow the script source.

The form or delete button fails with a security error​

The forms are protected by security tokens that can expire when a page is served from an old cache. If your account page is behind a full-page cache, exclude it from caching. Pages for logged-in users generally should not be cached anyway.

Author archive pages return a 404​

  • Enable Activate author archives for users who haven't produced any content under Settings > Beaver Profile Builder. By default WordPress only serves author archives for users with published posts.
  • Confirm your theme includes an author.php template.
  • Re-save permalinks under Settings > Permalinks to flush rewrite rules.

Contact support​

If none of the fixes above resolve the issue, contact Tangible support with your plugin version, WordPress version, and a description of what you tried.