Avataurus for WordPress

Replace default WordPress avatars with unique, deterministic face avatars.

How It Works

Each user's email address deterministically produces a unique avatar with distinct eyes, mouth, and background color. Same email, same face, every time.

Powered by Avataurus — an open source deterministic avatar generator.

Install

1. Upload the avataurus folder to /wp-content/plugins/
2. Activate the plugin
3. Go to Settings > Discussion > Default Avatar
4. Select Avataurus (Face) or Avataurus (Initial)

Features

• Zero config — activate and go
• Respects Gravatars — real Gravatar profile pictures are preserved
• Deterministic — same email = same avatar, always
• Fast — served from Cloudflare's edge (200+ locations)
• Privacy-friendly — no tracking, no cookies, no data collection
• Clean uninstall — removes all traces when deactivated

Filters

// Change the variant per context
add_filter( 'avataurus_variant', function( $variant, $id_or_email ) {
    // Use initials in admin, faces on frontend
    return is_admin() ? 'initial' : 'face';
}, 10, 2 );

// Modify the seed
add_filter( 'avataurus_seed', function( $seed, $id_or_email ) {
    return $seed;
}, 10, 2 );

// Modify the full avatar URL
add_filter( 'avataurus_avatar_url', function( $url, $id_or_email, $args ) {
    return $url;
}, 10, 3 );

License

GPL-2.0-or-later — as required for WordPress.org plugins.