Documentation
SwitchGuard
Switching From...

Switching From...

SwitchGuard adds switch controls in three places across the WordPress admin.

User List

The Switch to action link appears under each user in Users → All Users when:

  • You are logged in with edit_users capability.
  • The target user's role level is lower than yours.
  • SwitchGuard switching is enabled.

Click Switch to [username] to initiate the switch.


Order Screen

When Order Screen Button is enabled and WooCommerce is active, a Switch to Customer button appears on every WooCommerce order's detail screen.

This is particularly useful for:

  • Replicating a customer's issue with a specific order
  • Verifying what the customer sees in My Account for that order
  • Checking checkout re-entry or renewal flows

The button is only visible to users with edit_users capability and is hidden from shop managers who do not have the switch permission.


User Profile

When Profile Screen Box is enabled, a Switch to this User box appears at the bottom of each user's profile page (/wp-admin/user-edit.php?user_id=X).

The box shows:

  • Target user's display name and email
  • Their role
  • A Switch to [username] button

This provides a contextual switch option when reviewing a user's account settings.