WordPress Code Reference

get_avatar

Reading time

5 Minutes

Published

Join the Conversation

Summery Summery

Filters the avatar to retrieve.

apply_filters( 'get_avatar', string $avatar, mixed $id_or_email, int $size, string $default, string $alt, array $args )

$avatar: <img> tag for the user's avatar.
$id_or_email: The Gravatar to retrieve. Accepts a user_id, gravatar md5 hash, user email, WP_User object, WP_Post object, or WP_Comment object.
$size: Square avatar width and height in pixels to retrieve.
$default: URL for the default image or a default type. Accepts '404', 'retro', 'monsterid', 'wavatar', 'indenticon','mystery' (or 'mm', or 'mysteryman'), 'blank', or 'gravatar_default'. Default is the value of the 'avatar_default' option, with a fallback of 'mystery'.
$alt: Alternative text to use in the avatar image tag. Default empty.
$args: Arguments passed to get_avatar_data(), after processing.

Changelog
Version	Description
4.2.0	The `$args` parameter was added.
2.5.0	Introduced.