Users not loading – Ensure you're logged in and have permission to list users (e.g. list_users). Check that the FleekDash users endpoint (/wp-json/fleekdash/v1/users) is available and returns data. Look at the network tab for 403 or 404.
Role filter doesn't show custom roles – Custom roles appear in the "More roles…" (or similar) dropdown after native roles. If you don't see them, ensure roles were created via Role Management and the roles API returns them.
Edit drawer doesn't open – Ensure you clicked Edit on the correct row. The drawer is provided by the persistent drawer system; if it doesn't open, check the console for errors and that openUserEdit(user) is called with a valid user object.
Role change doesn't save – The inline role change calls PUT .../users/:id/roles. If it fails, check permissions (e.g. edit_users) and that the backend accepts the request. Revert may happen automatically on error; check for an error toast or message.
Cannot delete user – You cannot delete your own account. For other users, ensure you have delete_users capability. If the API returns 400 or 403, read the error message (e.g. "you cannot delete your own account").
Role Management: protected role – Native roles (e.g. Administrator) may have protected capabilities or limited editing to prevent breaking the site. Custom roles can usually be fully edited or deleted.
Add New goes to WordPress – "Add New" intentionally opens the WordPress user creation screen so you get the standard fields (e.g. password, send notification). After creating the user, return to #/users to manage them in FleekDash.
Quick reference
| Topic | Details |
Users page | #/users – Grid with avatars, name, email, roles, registered, actions. |
Role filter | All, Administrator, Editor, Author, Contributor, Subscriber, + More roles (custom). |
Search | Filters current list by name, username, email, role (client-side, debounced). |
Edit user | Row action Edit → User Edit drawer; save updates profile and roles. |
Change role | Inline in Roles column or in User Edit drawer. |
Role Management | Header button Roles (or from Menu Management drawer) → drawer: create/edit/delete roles, manage capabilities. |
Add user | Add New → WordPress user-new screen; then manage at #/users. |
Delete user | Row action Delete → confirmation drawer → confirm. Cannot delete self. |
APIs | FleekDash /fleekdash/v1/users (list, update, delete, roles); roles from roles API. |