Frequently Asked Questions

Find answers to the most common questions about Advanced Username Manager.

General Questions

Can users change their username from the frontend?

Yes, that’s the main purpose of this plugin. Users can change their login username from the frontend without accessing the WordPress admin dashboard. You can enable this through:

BuddyPress/BuddyBoss profile settings (if BuddyPress is active)
WooCommerce My Account page (if WooCommerce is active)
Any page using the [username_manager] shortcode

See the Shortcode Usage guide for details.

Can I restrict username changes to specific user roles?

Yes, you have complete control over which user roles can change their usernames. In the General Settings, you can select one or multiple roles (like Subscriber, Customer, Author, etc.).

Administrators always have permission to change usernames regardless of this setting.

See General Settings for configuration instructions.

Is there a limit on how often users can change their username?

Yes, you can set a cooldown period to prevent users from changing their username too frequently. Available options are:

7 Days – Users can change once per week
15 Days – Users can change twice per month
30 Days – Users can change once per month

This prevents abuse and maintains stability in your community.

Does the plugin provide real-time username availability checking?

Yes, the plugin includes a powerful real-time availability checker that validates usernames as users type. It provides:

Instant feedback on availability (green checkmark for available, red X for taken)
Validation messages for length requirements
Character validation (only letters, numbers, underscores, hyphens allowed)
Smart username suggestions if the desired username is taken

See Username Availability for more details.

What is the Unique Identifier feature?

The Unique Identifier feature generates random, permanent profile URLs instead of using usernames in the URL. This enhances privacy and prevents profile stalking.

Example:

Standard URL: https://example.com/members/john_doe/
Unique Identifier URL: https://example.com/members/aum5f8a3c9b1/

The unique identifier never changes, even when the username changes. This feature is only available for BuddyPress sites (not BuddyBoss).

See Unique Identifier documentation for full details.

Can I add a username change form to any page?

Yes, you can use the [username_manager] shortcode to add the username change form to any page, post, or widget area. Simply add:

[username_manager]

The form will display for logged-in users who have permission to change their username.

See Shortcode Usage for implementation details.

BuddyPress Questions

Does this plugin work with BuddyPress?

Yes, the plugin has full BuddyPress integration. When enabled, it adds a “Username Change” tab in the Profile Settings section where members can change their usernames.

The plugin is compatible with:

BuddyPress 5.0 or higher
BuddyBoss Platform 1.0 or higher

See BuddyPress Integration for setup instructions.

How do I enable username changes in BuddyPress?

Ensure BuddyPress or BuddyBoss is installed and active
Go to WB Plugins → Advanced Username Manager → General Settings
Enable “Enable Username Change in Profile”
Select the user roles allowed to change usernames
Click Save Changes

Members will now see a Username Change tab under Settings in their BuddyPress profile.

What happens to BuddyPress profile URLs when username changes?

It depends on your settings:

If using Username format:

Profile URL updates to match the new username
The old username-based URL will no longer resolve
All profile references update automatically

If using Unique Identifier format:

Profile URL stays the same (uses the permanent unique identifier)
Username change doesn’t affect the profile URL
Unique identifier URLs always work regardless of username changes

Does it work with BuddyBoss Platform?

Yes, the plugin works with BuddyBoss Platform. However, the Unique Identifier feature is only available for standard BuddyPress sites, not BuddyBoss.

WooCommerce Questions

Does this plugin work with WooCommerce?

Yes, the plugin has full WooCommerce integration. When enabled, it adds a “Change Username” tab in the WooCommerce My Account page.

The plugin is compatible with WooCommerce 4.0 or higher.

See WooCommerce Integration for setup instructions.

How do I enable username changes in WooCommerce?

Ensure WooCommerce is installed and active
Go to WB Plugins → Advanced Username Manager → General Settings
Enable “Enable Username Change in WooCommerce”
Select the Customer role (and any other roles you want)
Click Save Changes

Customers will now see a Change Username tab in their My Account page.

Can WooCommerce customers change their username?

Yes, as long as you:

Enable the WooCommerce integration in General Settings
Select the “Customer” role in the allowed user roles list
Customers will see the option in their My Account dashboard

Do customers stay logged in after changing their username?

Yes, customers remain logged in automatically after changing their username. The plugin handles authentication cookie updates seamlessly, so there’s no interruption to shopping or checkout.

Username Requirements

What characters are allowed in usernames?

Usernames can only contain:

Letters: a-z, A-Z
Numbers: 0-9
Underscore: _
Hyphen: –

Spaces and special characters (like @, #, $, %, etc.) are not allowed.

Can I set a minimum and maximum username length?

Yes, you can set both minimum and maximum character limits in the General Settings:

Go to General Settings
Find “Minimum Username Length” and enter your preferred minimum (e.g., 5)
Find “Maximum Username Length” and enter your preferred maximum (e.g., 12)
Click Save Changes

The plugin validates usernames both on the frontend (instant feedback) and backend (security check).

Can users change to a username that already exists?

No, the plugin prevents duplicate usernames. If a user tries to use a username that’s already taken, they’ll see an error message and a list of alternative suggestions they can choose from.

Can users change to the same username they already have?

No, the new username must be different from the current username. If a user tries to submit the same username, they’ll see the message: “Please enter a different Username!”

Security & Privacy

Is the plugin secure?

Yes, the plugin includes multiple security features:

Nonce Verification – Prevents CSRF attacks
Data Sanitization – Prevents SQL injection and XSS attacks
Role-Based Access Control – Users can only change their own username (unless they’re admins)
Rate Limiting – Cooldown period prevents abuse
Server-Side Validation – All checks happen on both frontend and backend

What happens to the old username?

When a user changes their username:

The old username is stored in the username change log (database table)
The old username becomes available for other users to claim
The old username is included in the email notification
For BuddyPress with Unique Identifier, old profile URLs continue to work

Can administrators change any user’s username?

Yes, administrators always have permission to change usernames regardless of role restrictions. This allows admins to:

Update usernames for support requests
Fix inappropriate or problematic usernames
Manage member accounts as needed

Do users receive notifications when their username is changed?

Yes, users receive an email notification every time their username is successfully changed. The email includes:

Confirmation that the username was changed
The new username
A security message to contact support if they didn’t request the change
Site name and branding

You can customize the email content and subject using filter hooks. See the Hooks and Filters documentation.

Technical Questions

Does it work with WordPress Multisite?

Yes, the plugin is compatible with WordPress Multisite. It properly handles super admin capabilities during username changes:

Super admin capabilities are temporarily revoked during username update
Capabilities are restored immediately after the update
This prevents issues with the WordPress multisite system

Will username changes break existing user data?

No, username changes only update the login username. All other user data remains intact:

User ID stays the same
Email address doesn’t change
User roles and capabilities remain
Post authorship is preserved
User meta data is preserved
Order history (WooCommerce) remains linked

Does it clear caches after username changes?

Yes, the plugin automatically clears relevant caches:

WordPress user cache
BuddyPress member caches (if applicable)
Authentication cookies (replaced with new ones)
Unique identifier caches

You may need to manually clear external caching (like CDN or page caching plugins).

Can I customize the plugin behavior?

Yes, the plugin provides multiple hooks and filters for developers:

Actions – Run custom code before/after username changes
Filters – Modify email content, access control, profile slugs, etc.

See the Hooks and Filters documentation for all available customization options.

Does it log username changes?

Yes, the plugin maintains a database table (wpusernamechange_logs) that records:

User ID
Old username
New username
Change date/time

This log is used for:

Rate limiting (cooldown period)
Audit trail
Support troubleshooting

Compatibility Questions

What version of WordPress is required?

The plugin requires WordPress 5.0 or higher.

What version of PHP is required?

The plugin requires PHP 7.4 or higher.

Does it work with my theme?

Yes, the plugin is theme-independent and works with any properly coded WordPress theme. The plugin:

Uses standard WordPress functions
Follows WordPress coding standards
Provides CSS hooks for styling customization

If you encounter styling issues with your specific theme, you can add custom CSS to match your theme’s design.

Does it work with page builders?

Yes, the [username_manager] shortcode works with all popular page builders:

Elementor – Use the Shortcode widget
Beaver Builder – Use the HTML module
Divi Builder – Use the Code module
WPBakery – Use the Raw HTML element
Gutenberg – Use the Shortcode block

See Shortcode Usage for specific instructions.

Can I use it alongside other user management plugins?

Generally yes, but it depends on the specific plugins. Advanced Username Manager is designed to work alongside:

Membership plugins (Paid Memberships Pro, MemberPress, etc.)
Profile plugins (BuddyPress, Ultimate Member, etc.)
E-commerce plugins (WooCommerce, Easy Digital Downloads, etc.)

If you experience conflicts, contact support for assistance.

Licensing & Support

Do I need a license to use the plugin?

Yes, Advanced Username Manager is a premium plugin that requires a valid license key for:

Plugin updates
Official support
Access to new features

Activate your license under WB Plugins → License.

How do I get support?

If you need help:

Check this documentation for answers
Visit the Troubleshooting guide
Submit a support ticket at https://wbcomdesigns.com/support
Email us at support@wbcomdesigns.com

Include your WordPress version, plugin version, and details about the issue for faster assistance.

Can I request new features?

Yes! We welcome feature requests from our customers. Submit your ideas through:

Support ticket system
Email to support@wbcomdesigns.com
Feature request form on our website

We regularly review customer feedback and add the most requested features to future updates.