Documentation
SwitchGuard Pro
Troubleshooting

Troubleshooting

Audit Log Empty After Switching

Confirm the Pro plugin is active

Check that the Pro plugin is active, not the free version.

Verify the database table

Check that the {prefix}switchguard_log table was created during activation. You can inspect this with phpMyAdmin or a database tool.

Test and inspect

Perform a switch and check the table directly with a database tool to confirm records are being written.


Frontend Bar Not Appearing

Check the setting

Confirm Enable Frontend Bar is turned on in Settings → Frontend Bar.

Verify your theme

Verify your theme calls wp_footer() - the bar is injected there.

Check for CSS conflicts

Check that no CSS rule from your theme or another plugin is hiding #switchguard-front-bar.


Floating Button Not Showing in Admin

Check the setting

Confirm Enable Floating Button is turned on in Settings → Floating Button.

Check for JavaScript errors

Open browser DevTools console and look for JavaScript errors on admin pages.

Confirm the correct plugin is active

Verify the Pro plugin is active and not the free version.


IP Allowlist Blocking Your Own IP

Access the database directly

Access WordPress directly via SFTP or phpMyAdmin.

Update the option

Update the switchguard_settings option to add your current IP to ip_allowlist.

Alternative: disable temporarily

Alternatively, disable the IP allowlist temporarily by setting enable_ip_allowlist to no in the option.