HTTP/2 301 date: Sun, 28 Dec 2025 23:35:46 GMT content-type: text/html; charset=UTF-8 location: https://generatewp.com/wp_user_query/ server: cloudflare cf-edge-cache: cache,platform=wordpress x-redirect-by: WordPress vary: User-Agent cf-cache-status: DYNAMIC nel: {"report_to":"cf-nel","success_fraction":0.0,"max_age":604800} report-to: {"group":"cf-nel","max_age":604800,"endpoints":[{"url":"https://a.nel.cloudflare.com/report/v4?s=RIg2MK888%2FNO9%2FPL%2FS1n8mAUPQh20Wvr4iQH1KMewkKvFKfSo558Zlbcjs8W1Kpnh1lKNy9CgIRplDuVfNUE0djEjKW2tSFr4YXoYiPv"}]} cf-ray: 9b54e0390f1a3b67-BOM alt-svc: h3=":443"; ma=86400 HTTP/2 200 date: Sun, 28 Dec 2025 23:35:48 GMT content-type: text/html; charset=UTF-8 server: cloudflare cf-edge-cache: cache,platform=wordpress link: ; rel="https://api.w.org/", ; rel=shortlink vary: Accept-Encoding,User-Agent report-to: {"group":"cf-nel","max_age":604800,"endpoints":[{"url":"https://a.nel.cloudflare.com/report/v4?s=%2Bt7KCvoxzWkN7c11oAwBhIpeAZPtdvlWesdySH3CdZYsNHNBlf5eYhl5Tl56uq6T%2FeAAXp6Wm8aVSlnBNOPX%2BZ9tHrvzQ%2BPCAgmUlPzh"}]} cf-cache-status: DYNAMIC nel: {"report_to":"cf-nel","success_fraction":0.0,"max_age":604800} content-encoding: gzip cf-ray: 9b54e0450afb3b67-BOM alt-svc: h3=":443"; ma=86400

• Generators
• Join
• Login

WP_User_Query Generator

•   
• General
• Role
• Include & Exclude
• Network
• Search
• Pagination
• Order
• Custom Fields
• Who
• Total Count
• Return Fields

Overview

Use this tool to create custom code for WordPress User Query with WP_User_Query class.

Usage

• Fill in the user-friendly form.
• Click the “Update Code” button.
• Copy the code to your project.
• Or save it as a snippet and share with the community.

Examples

If you are still learning how to use this tool, check out the following examples:

• Users from israel only
• Gmail users among authors
• Administrator role users ordered by display name
• Recently registered users

Query Variable Name The variable used in the code.

Show The Loop Yes No Show The Loop.

User Role Choose... Super Admin Administrator Editor Author Contributor Subscriber Custom User Role Show users associated with certain role.

Custom User Role Show users associated with custom role.

Include Show specific list of users to be included.
Comma separated list of ID's. e.g. 1, 2, 3

Exclude Show specific list of users to be excluded.
Comma separated list of ID's. e.g. 4, 5, 6

Blog ID Show users associated with certain blog on the network.

Search Keyword Show users based on a possible keyword.

Search Columns Comma separated list of database table columns to matches the search keywords. e.g. id, user_login, user_nicename, user_email, user_url

Number Number of users to show.

Offset Number of users to displace or pass over.

Order Choose... ASC - Default DESC Ascending or Descending order.

Order by Choose... ID Display Name User Name User Login (Default) User Nicename User Email User Url User Registered Date post_count Sort retrieved users by.

Meta Query No save snippets... Select from your saved WP_Meta_Query snippets.

Which users Which users to query. Currently only "authors" is supported. Default is all users.

Total Count Choose... True - Default False The total count of users found.

Return Fields Choose... All (Default) All With Meta Custom Fields Set the fields you want to return.

Custom Return Fields Comma separated list of fields to return. e.g. id, user_login, user_nicename, user_email, user_url, user_registered

Update Code   Save Snippet

// WP_User_Query arguments
$args = array(
);
// The User Query
$user_query = new WP_User_Query( $args );