Skip to main content

User

For loop type user, here are the query parameters and fields.

Query parameters

  • exclude - Exclude users by ID or name
    Type: string, array

  • id - User by ID
    Type: string, array

  • include - Include users by ID or name
    Type: string, array

  • name - User by name/slug
    Type: string, array

  • not_role - Exclude user role(s)
    Type: string, array

  • order - Order: asc (ascending) or desc (descending)
    Type: string - Default: asc

  • orderby - Order by field
    Type: string, array - Default: display_name

  • paged - Items per page
    Type: number - Default: 10

  • role - User role(s)
    Type: string, array

Fields

  • archive_url - Post archive URL

  • avatar - Avatar image

  • avatar_url - Avatar URL

  • edit_url - Edit URL

  • email - Email

  • full_name - Full name

  • id - ID

  • locale - User locale from the Language setting in profile edit screen

  • name - Name

  • post_count - Post count

  • registration_date - Registration date

  • roles - User role(s)

  • url - URL

User conditions

Current user is logged in

<If user exists>

Current user is not logged in

<If not user exists>

Current user is admin

<If user_role includes value=administrator>

User field value

<If user_field=field_name value="something">

User tag

The User tag is a shortcut to get a field from the current user.

Examples