Skip to content
Docs

Troubleshooting

Solutions to common issues. If your problem is not listed, contact the site’s support with what you were doing, what happened, any error message, and your browser and device.

Business Pages Show 404

Section titled “Business Pages Show 404”
  1. Go to Settings > Permalinks
  2. Click Save Changes to flush rewrite rules
  3. Clear any caching plugins

This is the most common fix after activating the plugin or changing a slug.

Business Creation

Section titled “Business Creation”

Cannot find the Create Business button

Section titled “Cannot find the Create Business button”
  • Confirm you are logged in.
  • Your account may have reached its creation limit, or the site may restrict creation for your role.
  • Confirm business creation is enabled by the site admin.

Business will not save

Section titled “Business will not save”
  • Fill in all required fields.
  • Try a smaller image if an upload failed.
  • Refresh the page (your session may have expired) and try again.

Display Issues

Section titled “Display Issues”

Map not showing

Section titled “Map not showing”
  • Visitors: enable JavaScript, disable ad blockers temporarily, or try another browser.
  • Admins (Google Maps): verify the API key, confirm the required APIs are enabled, and confirm billing is set up.
  • Admins: switching to OpenStreetMap removes the API-key requirement entirely.

Images not loading

Section titled “Images not loading”
  • Clear the browser cache.
  • Keep images under about 2MB and use JPG or PNG.
  • Confirm the upload finished before saving.

Shortcode shows as plain text

Section titled “Shortcode shows as plain text”
  • Confirm the plugin is active.
  • Check the shortcode for typos.
  • Re-add it in the block or shortcode editor.

Tabs

Section titled “Tabs”

An integration tab (Shop, Events, Jobs, Media) is missing

Section titled “An integration tab (Shop, Events, Jobs, Media) is missing”
  1. Confirm the host plugin (and any required add-on) is installed and active.
  2. Confirm the integration is enabled at WB Plugins > Business Profile > Integration.
  3. Confirm the owner enabled the tab in their business Manage Tabs settings.
  4. Flush permalinks at Settings > Permalinks > Save Changes.

Reviews

Section titled “Reviews”

Review not appearing

Section titled “Review not appearing”
  • It may be awaiting moderation, or a guest review may need approval.
  • It may have been caught by a spam filter.
  • Give it a few minutes, then contact the site admin.

Cannot submit a review

Section titled “Cannot submit a review”
  • Confirm you are logged in (if the site requires it).
  • You may have reached the review limit for that business.
  • Check the browser console for JavaScript errors.

Follow Button Not Working

Section titled “Follow Button Not Working”
  1. Confirm the BuddyPress Groups component is active.
  2. Confirm the business has an associated group.
  3. Check the browser console for JavaScript errors.

Widgets Not Appearing

Section titled “Widgets Not Appearing”
  1. The single-business widgets show only on business pages.
  2. The business owner may have disabled the widget in their Sidebar settings.
  3. A widget hides itself when it has no data, and the widget area must exist in your theme.

Notifications Not Arriving

Section titled “Notifications Not Arriving”
  1. Confirm the notification is enabled in your business Settings > Notifications.
  2. Check your spam or junk folder and confirm your email address is correct.
  3. Also check your BuddyPress notification settings.

Performance With Many Businesses

Section titled “Performance With Many Businesses”
  • Lower the number of businesses per page.
  • Enable object caching (Redis or Memcached).
  • Serve images through a CDN.
  • Consider disabling map view for very large directories.

More Help

Section titled “More Help”
  • FAQ
  • Contact Wbcom Designs support