Skip to content

Troubleshooting and FAQ

John James Jacoby edited this page Sep 16, 2026 · 1 revision

Troubleshooting and FAQ

A section is missing

Sections are conditional. Sites requires multisite, Other requires compatible third-party profile output, and integration sections require their plugins. Permissions also depend on the current user's capabilities.

A field from another plugin is missing

Check the Other section and confirm the plugin uses WordPress's standard profile hooks. If it replaces the original profile screen outright or relies on a fixed page filename, a dedicated integration may be required.

Changes do not save

Confirm the current user can edit the selected account, that the form was not open long enough for its nonce to expire, and that no validation error appears after submission. Role changes require additional promotion capabilities.

The old profile URL redirects

That is expected. WP User Profiles routes core profile and user-edit URLs into the sectioned interface while preserving the selected user and administration context.

Does it move user data into custom tables?

No. It uses WordPress's existing user fields, metadata, roles, capabilities, sessions, and application-password APIs.

Does it work on multisite?

Yes. It supports site, network, and user administration and adds a Sites section for membership and role management.

Where should bugs be reported?

Use GitHub Issues for reproducible development issues or the WordPress.org support forum for site support.

Clone this wiki locally