Title: get_avatar_data
Published: April 23, 2015
Last modified: August 20, 2026

---

# apply_filters( ‘get_avatar_data’, array $args, mixed $id_or_email )

## In this article

 * [Parameters](https://developer.wordpress.org/reference/hooks/get_avatar_data/?output_format=md#parameters)
 * [Source](https://developer.wordpress.org/reference/hooks/get_avatar_data/?output_format=md#source)
 * [Related](https://developer.wordpress.org/reference/hooks/get_avatar_data/?output_format=md#related)
 * [Changelog](https://developer.wordpress.org/reference/hooks/get_avatar_data/?output_format=md#changelog)

[ Back to top](https://developer.wordpress.org/reference/hooks/get_avatar_data/?output_format=md#wp--skip-link--target)

Filters the avatar data.

## 󠀁[Parameters](https://developer.wordpress.org/reference/hooks/get_avatar_data/?output_format=md#parameters)󠁿

 `$args`array

Arguments passed to [get_avatar_data()](https://developer.wordpress.org/reference/functions/get_avatar_data/),
after processing.

More Arguments from get_avatar_data( … $args )

Arguments to use instead of the default arguments.

 * `size` int
 * Height and width of the avatar in pixels. Default 96.
 * `height` int
 * Display height of the avatar in pixels. Defaults to $size.
 * `width` int
 * Display width of the avatar in pixels. Defaults to $size.
 * `default` string
 * URL for the default image or a default type. Accepts:
    - `'404'` (return a 404 instead of a default image)
    - `'retro'` (a 8-bit arcade-style pixelated face)
    - `'robohash'` (a robot)
    - `'monsterid'` (a monster)
    - `'wavatar'` (a cartoon face)
    - `'identicon'` (the “quilt”, a geometric pattern)
    - `'initials'` (initials based avatar with background color)
    - `'color'` (generated background color)
    - `'mystery'`, `'mm'`, or `'mysteryman'` (The Oyster Man)
    - `'blank'` (transparent GIF)
    - `'gravatar_default'` (the Gravatar logo) Default is the value of the `'avatar_default'`
      option, with a fallback of `'mystery'`.
 * `force_default` bool
 * Whether to always show the default image, never the Gravatar.
    Default false.
 * `rating` string
 * What rating to display avatars up to. Accepts:
    - `'G'` (suitable for all audiences)
    - `'PG'` (possibly offensive, usually for audiences 13 and above)
    - `'R'` (intended for adult audiences above 17)
    - `'X'` (even more mature than above) Default is the value of the `'avatar_rating'`
      option.
 * `scheme` string
 * URL scheme to use. See [set_url_scheme()](https://developer.wordpress.org/reference/functions/set_url_scheme/)
   for accepted values.
    For Gravatars this setting is ignored and HTTPS is used
   to avoid unnecessary redirects. The setting is retained for systems using the
   [‘pre_get_avatar_data’](https://developer.wordpress.org/reference/hooks/pre_get_avatar_data/)
   filter to customize avatars.
 * `processed_args` array
 * When the function returns, the value will be the processed/sanitized $args plus
   a “found_avatar” guess. Pass as a reference.
 * `extra_attr` string
 * HTML attributes to insert in the IMG element. Is not sanitized.

`$id_or_email`mixed

The avatar to retrieve. Accepts a user ID, Gravatar SHA-256 or MD5 hash, user email,
[WP_User](https://developer.wordpress.org/reference/classes/wp_user/) object, [WP_Post](https://developer.wordpress.org/reference/classes/wp_post/)
object, or [WP_Comment](https://developer.wordpress.org/reference/classes/wp_comment/)
object.

## 󠀁[Source](https://developer.wordpress.org/reference/hooks/get_avatar_data/?output_format=md#source)󠁿

    ```php
    return apply_filters( 'get_avatar_data', $args, $id_or_email );
    ```

[View all references](https://developer.wordpress.org/reference/files/wp-includes/link-template.php/)
[View on Trac](https://core.trac.wordpress.org/browser/tags/7.1/src/wp-includes/link-template.php#L4633)
[View on GitHub](https://github.com/WordPress/wordpress-develop/blob/7.1/src/wp-includes/link-template.php#L4633-L4633)

## 󠀁[Related](https://developer.wordpress.org/reference/hooks/get_avatar_data/?output_format=md#related)󠁿

| Used by | Description | 
| [get_avatar_data()](https://developer.wordpress.org/reference/functions/get_avatar_data/)`wp-includes/link-template.php` |

Retrieves default data about the avatar.

  |

## 󠀁[Changelog](https://developer.wordpress.org/reference/hooks/get_avatar_data/?output_format=md#changelog)󠁿

| Version | Description | 
| [4.2.0](https://developer.wordpress.org/reference/since/4.2.0/) | Introduced. |

## User Contributed Notes

You must [log in](https://login.wordpress.org/?redirect_to=https%3A%2F%2Fdeveloper.wordpress.org%2Freference%2Fhooks%2Fget_avatar_data%2F)
before being able to contribute a note or feedback.