{"id":2693,"date":"2026-09-20T15:33:45","date_gmt":"2026-09-20T13:33:45","guid":{"rendered":"https:\/\/www.molongui.com\/help\/?p=2693"},"modified":"2026-10-08T21:13:21","modified_gmt":"2026-10-08T19:13:21","slug":"author-avatars-how-they-work","status":"publish","type":"post","link":"https:\/\/www.molongui.com\/help\/author-avatars-how-they-work\/","title":{"rendered":"Author Avatars: How They Work"},"content":{"rendered":"\n<p>Molongui Authorship provides several ways to display an avatar for your authors. Depending on your settings and the information available for each author, the plugin can use a locally uploaded avatar, a Gravatar, a custom default avatar, or the default avatar configured in WordPress.<\/p>\n\n\n\n<p>This guide explains how the different avatar sources work, which one takes priority, and what happens when a particular avatar is not available.<\/p>\n\n\n\n<h2 class=\"wp-block-heading\">Available avatar sources<\/h2>\n\n\n\n<p>Molongui Authorship can use the following avatar sources:<\/p>\n\n\n\n<ul class=\"wp-block-list\">\n<li><strong>Local Avatar<\/strong> \u2014 An image uploaded directly to the author profile.<\/li>\n\n\n\n<li><strong>Gravatar<\/strong> \u2014 The avatar associated with the author&#8217;s email address on Gravatar.<\/li>\n\n\n\n<li><strong>Custom Default Avatar<\/strong> \u2014 An image you choose in Molongui Authorship to use when no author-specific avatar is available.<\/li>\n\n\n\n<li><strong>WordPress Default Avatar<\/strong> \u2014 The default avatar configured under <strong>Settings &gt; Discussion<\/strong> in WordPress. This is used as part of the normal Gravatar flow when appropriate.<\/li>\n\n\n\n<li><strong>Acronym<\/strong> \u2014 In some Molongui Authorship features, such as the Author Box or supported shortcodes, an acronym generated from the author&#8217;s name can also be used as a fallback.<\/li>\n<\/ul>\n\n\n\n<h2 class=\"wp-block-heading\">Avatar priority<\/h2>\n\n\n\n<p>When all three global avatar options are enabled, Molongui Authorship normally checks avatar sources in this order:<\/p>\n\n\n\n<p><strong>Local Avatar \u2192 Gravatar \u2192 Custom Default Avatar<\/strong><\/p>\n\n\n\n<p>The first available avatar is displayed.<\/p>\n\n\n\n<p>For example, if an author has a local avatar, it is used immediately and Gravatar is not needed. If no local avatar exists, Molongui Authorship can try Gravatar. If the author does not have a Gravatar, the Custom Default Avatar is displayed.<\/p>\n\n\n\n<h2 class=\"wp-block-heading\">How the global avatar settings affect the fallback chain<\/h2>\n\n\n\n<p>The avatar settings act as global switches. When you disable a source, Molongui Authorship removes it from the avatar resolution process.<\/p>\n\n\n\n<p>For example:<\/p>\n\n\n\n<ul class=\"wp-block-list\">\n<li><strong>Local Avatar ON + Gravatar ON + Custom Default ON:<\/strong> Local \u2192 Gravatar \u2192 Custom Default<\/li>\n\n\n\n<li><strong>Local Avatar OFF + Gravatar ON + Custom Default ON:<\/strong> Gravatar \u2192 Custom Default<\/li>\n\n\n\n<li><strong>Local Avatar ON + Gravatar OFF + Custom Default ON:<\/strong> Local \u2192 Custom Default<\/li>\n\n\n\n<li><strong>Local Avatar OFF + Gravatar OFF + Custom Default ON:<\/strong> Custom Default<\/li>\n\n\n\n<li><strong>Local Avatar ON + Gravatar OFF + Custom Default OFF:<\/strong> Local only<\/li>\n\n\n\n<li><strong>All avatar sources OFF:<\/strong> No avatar is displayed<\/li>\n<\/ul>\n\n\n\n<p>This makes it possible to configure the avatar system according to your site&#8217;s privacy requirements and visual preferences.<\/p>\n\n\n\n<h2 class=\"wp-block-heading\">What happens when the Custom Default Avatar is disabled?<\/h2>\n\n\n\n<p>If Gravatar is enabled but the Custom Default Avatar is disabled, Molongui Authorship lets the normal WordPress\/Gravatar process use the <strong>Default Avatar configured in WordPress<\/strong> when the author does not have a Gravatar.<\/p>\n\n\n\n<p>You can configure the WordPress Default Avatar under:<\/p>\n\n\n\n<p><strong>WordPress Dashboard &gt; Settings &gt; Discussion &gt; Default Avatar<\/strong><\/p>\n\n\n\n<p>The WordPress Default Avatar is therefore different from the <strong>Custom Default Avatar<\/strong> provided by Molongui Authorship.<\/p>\n\n\n\n<h2 class=\"wp-block-heading\">What happens when an author has no email address?<\/h2>\n\n\n\n<p>Gravatar requires an email address. If an author does not have a valid email address, Molongui Authorship skips Gravatar entirely.<\/p>\n\n\n\n<p>For example, with Local Avatars, Gravatar, and the Custom Default Avatar enabled:<\/p>\n\n\n\n<p><strong>Local Avatar \u2192 Custom Default Avatar<\/strong><\/p>\n\n\n\n<p>If the author has neither a local avatar nor an email address, the Custom Default Avatar is displayed.<\/p>\n\n\n\n<p>If the Custom Default Avatar is also disabled, no avatar is displayed.<\/p>\n\n\n\n<p>This is intentional. Molongui Authorship does not send unnecessary requests to Gravatar when there is no valid email address to check.<\/p>\n\n\n\n<h2 class=\"wp-block-heading\">Local author avatars<\/h2>\n\n\n\n<p>A Local Avatar is an image uploaded directly to an author profile. It does not require an external service and does not depend on the author&#8217;s email address.<\/p>\n\n\n\n<p>When Local Avatars are enabled and an author has one configured, the local image normally has the highest priority.<\/p>\n\n\n\n<p>Local avatars can be used by both <strong>WordPress Users<\/strong> and <strong>Guest Authors<\/strong>.<\/p>\n\n\n\n<h2 class=\"wp-block-heading\">Gravatar<\/h2>\n\n\n\n<p>Gravatar is an external avatar service that associates an image with an email address.<\/p>\n\n\n\n<p>When Gravatar is enabled, Molongui Authorship can request the Gravatar associated with the author&#8217;s email address whenever a higher-priority avatar source is not available.<\/p>\n\n\n\n<p>If the author does not have a Gravatar, Molongui Authorship continues through the configured fallback chain.<\/p>\n\n\n\n<p>You can completely disable Gravatar from the Molongui Authorship settings. When Gravatar is disabled, Molongui Authorship does not use it as an avatar source.<\/p>\n\n\n\n<p>This is particularly useful for websites that prefer to avoid requests to the Gravatar service.<\/p>\n\n\n\n<h2 class=\"wp-block-heading\">Custom Default Avatar<\/h2>\n\n\n\n<p>The Custom Default Avatar lets you choose your own image to display when an author does not have an available author-specific avatar.<\/p>\n\n\n\n<p>This is useful if you want all authors without an avatar to display your site&#8217;s logo, a branded placeholder, or another image of your choice instead of one of the standard WordPress avatars.<\/p>\n\n\n\n<p>The Custom Default Avatar is a global fallback. It does not replace an author&#8217;s Local Avatar or an existing Gravatar when those sources have higher priority and are enabled.<\/p>\n\n\n\n<h2 class=\"wp-block-heading\">WordPress Users and Guest Authors<\/h2>\n\n\n\n<p>The same global avatar rules apply to both WordPress Users and Molongui Guest Authors.<\/p>\n\n\n\n<p>Both types of authors can have:<\/p>\n\n\n\n<ul class=\"wp-block-list\">\n<li>A Local Avatar.<\/li>\n\n\n\n<li>An email address associated with a Gravatar.<\/li>\n\n\n\n<li>The Custom Default Avatar as a fallback.<\/li>\n<\/ul>\n\n\n\n<p>This means your avatar configuration remains consistent regardless of whether a post is written by a registered WordPress User or a Guest Author.<\/p>\n\n\n\n<h2 class=\"wp-block-heading\">Author Box avatar settings<\/h2>\n\n\n\n<p>The Author Box also provides settings that let you choose an avatar source and fallback behavior.<\/p>\n\n\n\n<p>These settings provide more control over the avatar displayed specifically inside the Author Box, but the global avatar settings still act as master switches.<\/p>\n\n\n\n<p>For example, if Gravatar is disabled globally, selecting Gravatar as the Author Box avatar source cannot re-enable Gravatar.<\/p>\n\n\n\n<p>This prevents individual display settings from overriding your site&#8217;s global avatar policy.<\/p>\n\n\n\n<h2 class=\"wp-block-heading\">Using avatars with the author avatar shortcode<\/h2>\n\n\n\n<p>Molongui Authorship Pro provides the <code>[molongui_author_avatar]<\/code> shortcode for displaying an author&#8217;s avatar independently from the Author Box.<\/p>\n\n\n\n<p>The shortcode can use the normal avatar resolution logic or explicitly request a particular source such as:<\/p>\n\n\n\n<ul class=\"wp-block-list\">\n<li><code>source=\"auto\"<\/code><\/li>\n\n\n\n<li><code>source=\"local\"<\/code><\/li>\n\n\n\n<li><code>source=\"gravatar\"<\/code><\/li>\n\n\n\n<li><code>source=\"acronym\"<\/code><\/li>\n<\/ul>\n\n\n\n<p>The global Local Avatar and Gravatar settings still act as master switches when these sources are requested explicitly.<\/p>\n\n\n\n<p>See the dedicated shortcode documentation for detailed examples and fallback behavior.<\/p>\n\n\n\n<h2 class=\"wp-block-heading\">Disabling Gravatar completely<\/h2>\n\n\n\n<p>If you do not want your site to use Gravatar, disable the <strong>Gravatar<\/strong> option in the Molongui Authorship avatar settings.<\/p>\n\n\n\n<p>Once disabled, Gravatar is removed from the avatar fallback chain.<\/p>\n\n\n\n<p>For example, with Local Avatars and the Custom Default Avatar enabled:<\/p>\n\n\n\n<p><strong>Local Avatar \u2192 Custom Default Avatar<\/strong><\/p>\n\n\n\n<p>No Gravatar is required for authors that use this configuration.<\/p>\n\n\n\n<h2 class=\"wp-block-heading\">Choosing the right avatar setup<\/h2>\n\n\n\n<p>There is no single avatar configuration that is best for every website. The appropriate setup depends on how you manage your authors and whether you want to use an external avatar service.<\/p>\n\n\n\n<p>Some common configurations are:<\/p>\n\n\n\n<ul class=\"wp-block-list\">\n<li><strong>Maximum flexibility:<\/strong> Enable Local Avatars, Gravatar, and the Custom Default Avatar.<\/li>\n\n\n\n<li><strong>No Gravatar requests:<\/strong> Enable Local Avatars and the Custom Default Avatar, and disable Gravatar.<\/li>\n\n\n\n<li><strong>Gravatar-focused setup:<\/strong> Disable Local Avatars and keep Gravatar enabled.<\/li>\n\n\n\n<li><strong>Local avatars only:<\/strong> Enable Local Avatars and disable both Gravatar and the Custom Default Avatar.<\/li>\n\n\n\n<li><strong>Single branded avatar fallback:<\/strong> Disable Local Avatars and Gravatar, and enable the Custom Default Avatar.<\/li>\n<\/ul>\n\n\n\n<h2 class=\"wp-block-heading\">Related guides<\/h2>\n\n\n\n<p>For step-by-step instructions, see the following avatar guides:<\/p>\n\n\n\n<ul class=\"wp-block-list\">\n<li><a href=\"\/help\/how-to-upload-a-custom-avatar-for-an-author\/\">How to Upload a Custom Avatar for an Author<\/a><\/li>\n\n\n\n<li><a href=\"\/help\/how-to-upload-a-custom-avatar-for-a-guest-author\/\">How to Upload a Custom Avatar for a Guest Author<\/a><\/li>\n\n\n\n<li><a href=\"\/help\/how-to-change-or-remove-an-authors-custom-avatar\/\">How to Change or Remove an Author&#8217;s Custom Avatar<\/a><\/li>\n\n\n\n<li><a href=\"\/help\/how-to-set-a-custom-default-avatar\/\">How to Set a Custom Default Avatar<\/a><\/li>\n\n\n\n<li><a href=\"\/help\/how-to-disable-gravatar\/\">How to Disable Gravatar<\/a><\/li>\n\n\n\n<li><a href=\"\/help\/how-to-disable-local-author-avatars\/\">How to Disable Local Author Avatars<\/a><\/li>\n\n\n\n<li><a href=\"\/help\/how-to-use-only-local-avatars\/\">How to Use Only Local Avatars<\/a><\/li>\n\n\n\n<li><a href=\"\/help\/how-to-use-wordpress-default-avatar\/\">How to Use WordPress&#8217; Default Avatar<\/a><\/li>\n\n\n\n<li><a href=\"\/help\/how-to-configure-the-avatar-shown-in-the-author-box\/\">How to Configure the Avatar Shown in the Author Box<\/a><\/li>\n<\/ul>\n\n\n\n<p><\/p>\n","protected":false},"excerpt":{"rendered":"<p>Molongui Authorship provides several ways to display an avatar for your authors. Depending on your settings and the information available for each author, the plugin can use a locally uploaded avatar, a Gravatar, a custom default avatar, or the default avatar configured in WordPress. This guide explains how the different avatar sources work, which one [&hellip;]<\/p>\n","protected":false},"author":1,"featured_media":0,"comment_status":"closed","ping_status":"closed","sticky":false,"template":"","format":"standard","meta":{"footnotes":""},"categories":[26,1],"tags":[61,28],"class_list":["post-2693","post","type-post","status-publish","format-standard","hentry","category-authorship","category-doc","tag-avatar","tag-first-steps"],"_links":{"self":[{"href":"https:\/\/www.molongui.com\/help\/wp-json\/wp\/v2\/posts\/2693","targetHints":{"allow":["GET"]}}],"collection":[{"href":"https:\/\/www.molongui.com\/help\/wp-json\/wp\/v2\/posts"}],"about":[{"href":"https:\/\/www.molongui.com\/help\/wp-json\/wp\/v2\/types\/post"}],"author":[{"embeddable":true,"href":"https:\/\/www.molongui.com\/help\/wp-json\/wp\/v2\/users\/1"}],"replies":[{"embeddable":true,"href":"https:\/\/www.molongui.com\/help\/wp-json\/wp\/v2\/comments?post=2693"}],"version-history":[{"count":7,"href":"https:\/\/www.molongui.com\/help\/wp-json\/wp\/v2\/posts\/2693\/revisions"}],"predecessor-version":[{"id":2732,"href":"https:\/\/www.molongui.com\/help\/wp-json\/wp\/v2\/posts\/2693\/revisions\/2732"}],"wp:attachment":[{"href":"https:\/\/www.molongui.com\/help\/wp-json\/wp\/v2\/media?parent=2693"}],"wp:term":[{"taxonomy":"category","embeddable":true,"href":"https:\/\/www.molongui.com\/help\/wp-json\/wp\/v2\/categories?post=2693"},{"taxonomy":"post_tag","embeddable":true,"href":"https:\/\/www.molongui.com\/help\/wp-json\/wp\/v2\/tags?post=2693"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}