Troubleshooting

This guide helps you diagnose and fix common issues with Advanced Username Manager. Follow the solutions step-by-step for the best results.

Username Change Not Working

Problem: Form Submits But Username Doesn’t Change

Symptoms:

• Click Save Changes button
• Success message appears
• But username remains the same

Solution 1: Check Database Permissions

WordPress needs proper database write permissions. Contact your hosting provider if you see database errors in the debug log.

Solution 2: Check for Plugin Conflicts

1. Deactivate all other plugins except Advanced Username Manager
2. Try changing the username again
3. If it works, reactivate plugins one by one to find the conflict
4. Contact support about the conflicting plugin

Solution 3: Clear All Caches

1. Clear browser cache (Ctrl+Shift+Delete or Cmd+Shift+Delete)
2. Clear WordPress cache (if using a caching plugin)
3. Clear server cache (contact your host if needed)
4. Try again

Solution 4: Check WordPress Debug Log

1. Enable WordPress debugging in wp-config.php:

   define( 'WP_DEBUG', true );
   define( 'WP_DEBUG_LOG', true );
   define( 'WP_DEBUG_DISPLAY', false );

2. Try changing username again
3. Check wp-content/debug.log for error messages
4. Share errors with support if needed

---

Problem: “You Do Not Have Permission” Message

Symptoms:

• User sees error: “You do not have permission to change usernames”
• User should have access but doesn’t

Solution 1: Verify User Role is Selected

1. Go to WB Plugins → Advanced Username Manager → General Settings
2. Check “Select User Role(s)” section
3. Ensure the user’s role is selected (e.g., Subscriber, Customer, etc.)
4. Click Save Changes

Verify the user’s role is in the selected roles list

Solution 2: Check if Feature is Enabled

For BuddyPress:

1. Verify “Enable Username Change in Profile” is toggled ON
2. Click Save Changes

For WooCommerce:

1. Verify “Enable Username Change in WooCommerce” is toggled ON
2. Click Save Changes

Solution 3: Log Out and Log Back In

Sometimes role permissions need a fresh session:

1. Log out completely
2. Clear browser cookies
3. Log back in
4. Try accessing the feature again

---

Problem: Rate Limit / Cooldown Error

Symptoms:

• Message: “You have already updated your username. You can change it again after [date].”
• User needs to change username urgently

Solution 1: Wait for Cooldown Period to Expire

This is by design to prevent abuse. Users must wait until the date shown in the message.

Solution 2: Administrator Override

If a user has a legitimate reason to change username immediately:

1. Log in as an administrator
2. Go to Users → All Users
3. Edit the user’s account
4. Use a database query to reset the cooldown (for advanced users only):

DELETE FROM wp_username_change_logs WHERE user_id = [USER_ID];

Replace [USER_ID] with the actual user ID. Use with caution.

Solution 3: Adjust Cooldown Period

For future changes, adjust the cooldown period:

1. Go to General Settings
2. Change “Username Change Limit” to a shorter period (7 days instead of 30)
3. Click Save Changes

This only affects future username changes, not the current cooldown.

---

Problem: “Username Already Exists” Error

Symptoms:

• User tries to save a username
• Error: “Sorry, this username is already in use”
• User claims the username should be available

Solution 1: Choose a Different Username

This error means another WordPress user already has that username. The user needs to:

1. Choose a different username
2. Click on one of the suggested alternatives
3. Or modify the desired username (add numbers, etc.)

Solution 2: Check for Deleted Users

Usernames from deleted WordPress users remain in the database. To reclaim a username:

1. Go to Users → All Users (as admin)
2. Check if the username exists in inactive/deleted users
3. Permanently delete the user if appropriate
4. The username becomes available immediately

Solution 3: Database Check

For advanced users, verify in the database:

SELECT * FROM wp_users WHERE user_login = 'username_here';

This shows if the username exists and which user ID owns it.

---

BuddyPress Integration Issues

Problem: Username Change Tab Not Showing in BuddyPress

Symptoms:

• BuddyPress Settings page doesn’t have a “Username Change” tab
• Feature is enabled in plugin settings

Solution 1: Verify BuddyPress Settings Component

1. Go to Settings → BuddyPress → Components
2. Ensure “Account Settings” is checked
3. Click Save Settings
4. Refresh the profile page

The Settings component must be active

Solution 2: Check Plugin Settings

1. Go to WB Plugins → Advanced Username Manager → General Settings
2. Verify “Enable Username Change in Profile” is ON
3. Verify your user role is selected in “Select User Role(s)”
4. Click Save Changes

Solution 3: Flush Rewrite Rules

1. Go to Settings → Permalinks
2. Click Save Changes (don’t change anything)
3. This flushes WordPress rewrite rules
4. Check the profile page again

Solution 4: Check You’re on Your Own Profile

The tab only appears when viewing your own profile (or if you’re a super admin viewing another profile). Make sure you’re logged in and on your own profile page.

Solution 5: Clear BuddyPress Cache

If using a BuddyPress cache plugin:

1. Clear all BuddyPress caches
2. Clear site cache
3. Refresh the page

---

Problem: BuddyPress Profile URL Shows 404 After Username Change

Symptoms:

• Changed username successfully
• Profile page now shows 404 error
• Can’t access profile

Solution 1: Clear All Caches

1. Clear browser cache
2. Clear WordPress cache (WP Rocket, W3 Total Cache, etc.)
3. Clear BuddyPress object cache
4. Wait a few minutes for caches to fully clear

Solution 2: Flush Permalinks

1. Go to Settings → Permalinks
2. Click Save Changes
3. This regenerates rewrite rules
4. Try accessing the profile with the new username URL

Solution 3: Use Unique Identifier URL

If you enabled the Unique Identifier feature:

1. The profile URL should use the unique identifier, not the username
2. Try accessing: https://example.com/members/aum[identifier]/
3. Check your email for the success notification (may contain the correct URL)

Solution 4: Manually Navigate

1. Go to the site homepage
2. Click on Members directory
3. Search for the user by display name
4. Click on the profile from search results

This often rebuilds the proper URL association.

---

Problem: BuddyPress Activity Stream Shows Old Username

Symptoms:

• Username changed successfully
• Activity stream still displays old username
• Profile shows new username correctly

Solution: Clear BuddyPress Activity Cache

The activity cache needs time to update:

1. Clear all site caches
2. Wait 5-10 minutes
3. Refresh the page
4. If still showing old username, clear cache again

For persistent issues, BuddyPress caching plugins may need configuration adjustments.

---

WooCommerce Integration Issues

Problem: Change Username Tab Not Showing in WooCommerce

Symptoms:

• WooCommerce My Account page doesn’t have “Change Username” tab
• Feature is enabled in plugin settings

Solution 1: Verify WooCommerce is Active

1. Go to Plugins → Installed Plugins
2. Ensure WooCommerce is Active
3. If not, activate WooCommerce

Solution 2: Check Plugin Settings

1. Go to WB Plugins → Advanced Username Manager → General Settings
2. Verify “Enable Username Change in WooCommerce” is ON
3. Verify Customer role is selected in “Select User Role(s)”
4. Click Save Changes

Solution 3: Flush Rewrite Rules

1. Go to Settings → Permalinks
2. Click Save Changes (don’t change anything)
3. This registers the custom endpoint
4. Check My Account page again

Solution 4: Check Permalink Structure

The plugin requires permalinks to be enabled:

1. Go to Settings → Permalinks
2. Ensure you’re NOT using “Plain” permalinks
3. Select any other structure (Post name recommended)
4. Click Save Changes

Solution 5: Deactivate and Reactivate Plugin

Sometimes reactivation is needed to register endpoints:

1. Go to Plugins → Installed Plugins
2. Deactivate Advanced Username Manager
3. Reactivate Advanced Username Manager
4. Go to Settings → Permalinks and save
5. Check My Account page

---

Problem: WooCommerce Change Username Page Shows 404

Symptoms:

• Click “Change Username” tab
• Page shows 404 error

Solution 1: Flush Rewrite Rules

1. Go to Settings → Permalinks
2. Click Save Changes
3. Try accessing the page again

Solution 2: Check Permalink Structure

1. Ensure permalinks are enabled (not “Plain”)
2. Try changing to “Post name” structure
3. Save and test again

Solution 3: Deactivate and Reactivate

1. Deactivate Advanced Username Manager
2. Reactivate it
3. Go to Settings → Permalinks and save
4. Test the page

---

Problem: WooCommerce Customers Can’t Change Username

Symptoms:

• Tab appears in My Account
• Customer sees permission error when trying to change

Solution: Verify Customer Role is Selected

1. Go to General Settings
2. Check “Select User Role(s)”
3. Ensure Customer is selected
4. Click Save Changes
5. Have customer log out and back in

---

Shortcode Issues

Problem: Shortcode Displays as Text

Symptoms:

• Added [username_manager] to a page
• Shortcode appears as [username_manager] instead of showing the form

Solution 1: Check for Typos

Ensure you’re using the exact shortcode:

• Correct: [username_manager]
• Wrong: [username-manager], [username_change], [user_manager]

Solution 2: Verify Plugin is Active

1. Go to Plugins → Installed Plugins
2. Ensure Advanced Username Manager is active
3. If not, activate it

Solution 3: Switch Editor Mode

In Gutenberg:

1. Switch to Code Editor (three dots → Code editor)
2. Verify the shortcode is properly formatted
3. Switch back to Visual Editor

In Classic Editor:

1. Switch to Text tab
2. Check the shortcode syntax
3. Switch back to Visual tab

Solution 4: Check for Extra Spaces

Ensure no spaces inside the brackets:

• Correct: [username_manager]
• Wrong: [ username_manager ], [username_manager ]

---

Problem: Shortcode Shows “You Need to Log In” Message

Symptoms:

• Shortcode displays properly
• Shows message: “To change your username, please log in first.”
• User is already logged in

Solution 1: Clear Browser Cache and Cookies

1. Clear all browser cache and cookies
2. Log out completely
3. Log back in
4. Reload the page

Solution 2: Check for Caching Plugin Issues

If using a page caching plugin:

1. Exclude the username change page from cache
2. Or disable caching for logged-in users
3. Clear all caches
4. Test again

Solution 3: Verify User Session

Sometimes sessions expire:

1. Log out
2. Close all browser tabs
3. Reopen browser
4. Log in again
5. Try the page

---

Problem: Save Button Stays Disabled

Symptoms:

• Enter a new username
• Save Changes button remains grayed out
• Can’t click it

Solution 1: Check Username Availability

The button only enables when username is valid and available:

1. Ensure you see green checkmark (username available)
2. If red X appears, choose a different username
3. Check that username meets length requirements

Solution 2: Check Browser Console

1. Open browser developer tools (F12)
2. Go to Console tab
3. Look for JavaScript errors
4. Share errors with support if present

Solution 3: Disable Browser Extensions

Browser extensions can interfere with JavaScript:

1. Disable all browser extensions
2. Reload the page
3. Try again
4. If it works, enable extensions one by one to find the conflict

Solution 4: Try Different Browser

Test in a different browser to rule out browser-specific issues:

• Chrome
• Firefox
• Safari
• Edge

---

License Issues

Problem: Can’t Activate License

Symptoms:

• Enter license key
• Click Activate License
• Error message or no activation

Solution 1: Verify License Key

1. Check your purchase email for the correct license key
2. Copy the key carefully (no extra spaces)
3. Paste it in the license field
4. Try activating again

Solution 2: Check License Status

1. Log in to your Wbcom Designs account
2. Check if the license is active
3. Verify it hasn’t expired
4. Check how many sites it’s activated on (limit may be reached)

Solution 3: Deactivate from Other Sites

If you’ve reached the activation limit:

1. Log in to your Wbcom Designs account
2. Go to your licenses
3. Deactivate the license from old/test sites
4. Try activating on the current site

Solution 4: Contact Support

If none of the above work:

1. Contact Wbcom Designs support
2. Provide your license key and purchase email
3. They can manually activate or reset your license

---

Problem: Not Receiving Updates

Symptoms:

• New plugin version available
• Updates don’t appear in WordPress dashboard

Solution: Verify License is Active

1. Go to WB Plugins → License
2. Check license status shows “Active”
3. If not, activate your license
4. Go to Dashboard → Updates to check for updates

Updates only appear when license is active.

---

Email Notification Issues

Problem: Users Not Receiving Email Notifications

Symptoms:

• Username changes successfully
• No email confirmation received

Solution 1: Check Spam Folder

Email may be marked as spam:

1. Check user’s spam/junk folder
2. Mark as “Not Spam” if found
3. Add sender to contacts

Solution 2: Verify WordPress Email Functionality

Test if WordPress can send emails:

1. Install “Check Email” or “WP Mail SMTP” plugin
2. Send a test email
3. If test fails, WordPress email isn’t working
4. Configure SMTP settings (recommended: WP Mail SMTP plugin)

Solution 3: Check Email Address

1. Verify user’s email address is correct in their profile
2. Go to Users → Profile (or user profile)
3. Check the email field
4. Update if incorrect

Solution 4: Configure SMTP

WordPress default email is unreliable. Use SMTP:

1. Install WP Mail SMTP plugin
2. Configure with your email provider (Gmail, SendGrid, etc.)
3. Test email sending
4. Try username change again

---

Performance Issues

Problem: Username Availability Check is Slow

Symptoms:

• Type a username
• Takes several seconds to check availability
• Slow response time

Solution 1: Check Internet Connection

Slow internet affects AJAX requests:

1. Test your internet speed
2. Try on a different network
3. Contact your ISP if consistently slow

Solution 2: Check Server Performance

1. Contact your hosting provider
2. Ask about server load/performance
3. May need to upgrade hosting plan

Solution 3: Disable Heavy Plugins Temporarily

Some plugins slow down AJAX:

1. Deactivate non-essential plugins
2. Test username availability
3. Reactivate plugins one by one to find the culprit

Solution 4: Enable Object Caching

If your host supports it:

1. Enable Redis or Memcached
2. This speeds up database queries
3. Contact host for setup assistance

---

Debug Mode

When troubleshooting, enable WordPress debug mode to see detailed error messages.

Enable Debug Mode

Add to wp-config.php:

define( 'WP_DEBUG', true );
define( 'WP_DEBUG_LOG', true );
define( 'WP_DEBUG_DISPLAY', false );
@ini_set( 'display_errors', 0 );

Check Debug Log

Errors are logged to: wp-content/debug.log

1. Access via FTP or hosting file manager
2. Look for recent errors related to “advanced-username-manager”
3. Share errors with support if needed

Disable Debug Mode

After troubleshooting, set back to:

define( 'WP_DEBUG', false );

---

Getting Support

If you’ve tried the solutions above and still have issues:

Before Contacting Support

Gather this information:

1. WordPress Version - Dashboard → Updates
2. PHP Version - Site Health → Info → Server
3. Plugin Version - Plugins → Installed Plugins
4. Active Theme - Appearance → Themes
5. Error Messages - Copy exact error text
6. Screenshots - Capture the issue visually
7. Debug Log - Include relevant errors
8. Steps to Reproduce - How to trigger the issue

Contact Support

Support Portal: https://wbcomdesigns.com/support

Email: support@wbcomdesigns.com

Include:

• Your license key
• Site URL (if possible)
• All information from “Before Contacting Support” above

We typically respond within 24-48 hours on business days.

---

Related Documentation

• Frequently Asked Questions - Common questions
• General Settings - Plugin configuration
• BuddyPress Integration - BuddyPress setup
• WooCommerce Integration - WooCommerce setup
• Shortcode Usage - Shortcode implementation
• Hooks and Filters - Developer customization