User data


[su_user field="display_name" user_id="2"]


This shortcode allows you to display user data.


Option namePossible valuesDefault value
User data field name. Custom meta field names are also allowed.
first_name (First Name)
last_name (Last Name)
nickname (Nickname)
description (Description)
locale (Locale)
display_name (Display name)
user_login (Login)
user_nicename (Nice name)
user_url (URL)
user_registered (Registered)
user_status (Status)
This text will be shown if data is not found
Any text value– none –
This content will be shown before the value
Any text value– none –
This content will be shown after the value
Any text value– none –
You can specify custom user ID. Leave this field empty to use an ID of the current user
Any text value– none –
You can apply custom filter to the retrieved value. Enter here function name. Your function must accept one argument and return modified value. Name of your function must include word filter. Example function:
function my_custom_filter( $value ) {return 'Value is: ' . $value;}
Any text value– none –

User: field is not allowed

Since version 5.12.8 the plugin only allows you to display a set of specific user fields (see the Options table above for the full list). Any fields that are not whitelisted will trigger the “field is not allowed” error.

This mechanism was introduced to improve the plugin security, since the shortcode can be used, for example, by a contributor user to access sensitive information about any user of the site.

The list of allowed fields can be extended with the su/config/user_fields filter. To whitelist a specific field, add the code below to the end of the functions.php file of active theme. Please be careful, since the added field can be used by other writers on your site.

add_filter( 'su/config/user_fields', function( $fields ) {
	// The field 'user_registered' will be whitelisted
	// and the 'User Registration Date' string will be used in the Insert Shortcode window
	$fields['user_registered'] = 'User Registration Date';
	return $fields;
} );
🤝 Thank you!