Skip to content


Subversion checkout URL

You can clone with
Download ZIP
This plugin provides a taglib for displaying avatars. At the moment we only support gravatars (globally-recognized avatars).
Groovy Java
Branch: master
Failed to load latest commit information.
grails-app improved sample app
test/unit/com/synergyj/grails/plugins/avatar added spock spec to reproduce the bug;
.gitignore deleted unused IDE files
AvatarGrailsPlugin.groovy deleted unused closures fixed history log
LICENSE.txt added Licence
README Start Coding #12 upgraded to Grails 2.2.1 closes #14



The official documentation is locate at:

This plugin provides a taglib for displaying avatars. At the moment we only support gravatars (globally-recognized avatars).

Gravatars allow users to configure an avatar to go with their email address at a central location: Gravatar-aware websites can then look up and display each user‘s preferred avatar, without having to handle avatar management. The user gets the benefit of not having to set up an avatar for each site that they post on.

Plugin code is located at GitHub

'grails install-plugin avatar'


The plugin usage is quite simple.

'For Gravatar image'

Example: <avatar:gravatar email="${}"/>

The tagLib will generate the following HTML code: 
<img alt="Gravatar" class="avatar" height="20" src="" width="20" />

As you can see, the taglib will generate some html default attributes like:

 * id & name
 * heigth & width
 * CSS class
 * alt

You can customize this default values as follows: 
<avatar:gravatar email="${}" alt="My Avatar" cssClass="myCss" size="50"/>

<img alt="My Avatar" class="myCss" height="50" src="" width="50" />

Alternatively you can customize default avatar to users who don't have a Gravatar Account:
<avatar:gravatar email="${}" defaultGravatarUrl="${''.encodeAsURL()}" />

Also can be set the Gravatar rating:
<avatar:gravatar email="${}" gravatarRating="G" />

'For twitter image'

Example: <avatar:twitter user="${user.twitter}"/>

<img alt='twitter' class='avatar' height='50' width='50' src='' title='twitter'/>

You can customize:
 * heigth & width
 * CSS class
 * alt

'For facebook image'

Example: <avatar:facebook user="${user.facebookId}"/>

<img alt='facebook' class='avatar' height='50' width='50' src='' title='facebook'/>

You can customize:
 * heigth & width
 * CSS class
 * alt


To avoid expensive configuration each time plugin usage, you can configure global settings as follows:

In Config.groovy for Gravatar service

avatarPlugin {

To use twitter and/or facebook avatars you don't need configuration
Something went wrong with that request. Please try again.