Troubleshooting

Something not working right? Let’s figure it out.

Module Issues#

Module doesn’t seem to do anything#

First, check the basics:

1. Is it actually enabled? Look for the toggle in the on position.
2. Are you looking in the right place? Check the “Where to Find” section on the module card. Some modules work on the frontend, some in admin, some automatically.
3. Clear your cache. If you use a caching plugin, clear it. Same for CDN or browser cache.
4. Check the post type. Some modules only work on posts, or only on pages. Check the module settings.

Module conflicts with another plugin#

Switchboard modules are designed to play nice, but conflicts with other plugins can happen.

Quick test:

1. Disable the other plugin temporarily
2. See if the Switchboard module works now
3. If yes, there’s a conflict

Common conflicts:

• Multiple plugins doing the same thing (two TOC plugins, two social share plugins)
• Security plugins blocking AJAX requests
• Aggressive caching plugins

Solution: Usually you’ll choose one or the other. If you need both plugins, contact support — we might be able to help with compatibility.

Settings aren’t saving#

If you click Save but settings don’t stick:

1. Check for JavaScript errors. Open browser dev tools (F12), go to Console, look for red errors.
2. AJAX might be blocked. Some security plugins block admin AJAX. Try disabling them temporarily.
3. Check user permissions. You need to be an administrator.
4. Try a different browser. Rules out browser-specific issues.

License Issues#

“Invalid license key”#

• Make sure you copied the entire key with no extra spaces
• Check it’s a Switchboard Pro key, not for a different product
• Try copy-pasting directly from your account dashboard

“Activation limit reached”#

You’ve used all slots for your license tier.

Options:

• Deactivate an old site you’re not using
• Upgrade your license for more slots
• Wait 30 days for inactive sites to auto-release

License shows unlicensed after migration#

If you moved your site to a new domain:

1. The old activation is tied to the old URL
2. You need to activate again with your license key
3. The old activation will auto-release in 30 days

Can’t connect to license server#

Your server might be blocking outbound connections. Common causes:

• Firewall rules blocking HTTPS requests
• Security plugins with strict outbound filtering
• Some hosts restricting API calls

Check with your hosting provider or temporarily disable security plugins to test.

Performance Issues#

Dashboard loads slowly#

The first load after an update might be slow — Switchboard rebuilds its module cache. Subsequent loads should be fast.

If it’s consistently slow:

1. Check your hosting. Shared hosting under load can slow admin pages.
2. Disable other plugins temporarily. See if something else is the culprit.
3. Check for PHP errors. Go to wp-content/debug.log if debug logging is enabled.

Site feels slower after enabling modules#

Modules are lightweight, but here’s how to check:

1. Test one at a time. Disable all Switchboard modules. Enable them one by one, testing speed each time.
2. Check frontend modules. Modules that add content (TOC, reading time) do add some processing.
3. Look for duplicate functionality. If you have another plugin doing the same thing, they might both be running.

Display Issues#

Module output looks wrong#

Usually a CSS conflict with your theme.

Quick fix: Inspect the element (right-click → Inspect), see what styles are applied. You might need to add custom CSS to override your theme’s styles.

Each module wraps its output in a class like switchboard-reading-time or switchboard-toc. Use these to target your CSS.

Module appears in the wrong place#

For modules with position settings (like Reading Time or TOC):

1. Check the position setting in the module config
2. Some themes filter the_content in unusual ways — the module inserts correctly, but the theme moves things around

You can often use the shortcode instead for precise placement.

Getting Help#

Debug Mode#

Enable debug mode to get more information:

1. Go to Switchboard → Settings
2. Enable Debug Mode
3. Reproduce the issue
4. Check browser console and PHP error logs

This gives you (and us) more context about what’s happening.

Contacting Support#

Before reaching out, gather this info:

• WordPress version
• PHP version
• Switchboard Pro version
• Which module(s) are affected
• Steps to reproduce the issue
• Any error messages (screenshots help)

Get support:

• Email: support@wpswitchboard.com
• Use the feedback button in the dashboard

We typically respond within 24 hours on business days.

Reporting Bugs#

Found a bug? We want to know. Use the feedback button or email us with:

• What you expected to happen
• What actually happened
• Steps to reproduce
• Your environment details

Detailed bug reports help us fix things faster.

That covers the basics. For module-specific documentation, check out the Modules section.