Skip to content


Switch branches/tags

Name already in use

A tag already exists with the provided branch name. Many Git commands accept both tag and branch names, so creating this branch may cause unexpected behavior. Are you sure you want to create this branch?

Latest commit


Git stats


Failed to load latest commit information.
Latest commit message
Commit time

Grav Admin Identicons Plugin

Use identicons for avatars in the Admin-plugin, through customizable, yet classical identicons and classical patterns. The default configuration yields an avatar like this:

Default Identicon

Every user avatar is unique, as users full names are hashed into virtually random strings used for generating the identicons.

Installation and Configuration

  1. Download the zip version of this repository and unzip it under /your/site/grav/user/plugins.
  2. Rename the folder to adminidenticons.

You should now have all the plugin files under


The plugin is enabled by default, and can be disabled by copying user/plugins/adminidenticons/adminidenticons.yaml into user/config/plugins/adminidenticons.yaml and setting enabled: false.


All settings can be set through adminidenticons.yaml, or using the Admin-plugin interface. Overview:

Variable Default Options Note
enabled true true or false
type identicon identicon or pattern
border_radius 100 0 to 100
background '#f8f8f8' Hex color code Encapsulated in quotes.
foreground '#64F0FF' Hex color code Encapsulated in quotes.
varied true true or false Sets varied-color mode for identicon-type.
padding 28 4 to 60 Padding around identicon-type.
spacing 0 0 to 30 Space between tiles inidenticon-type.
rows 0 0 to 20 Rows inidenticon-type.
columns 0 0 to 20 Columns inidenticon-type.
tiles 6 1 to 25 Number of patterns inpattern-type.
colors 2 1 to 25 Number of colors inpattern-type.

Note: Values higher than 12 for tiles or colors cause higher levels of memory- and processing power-usage by PHP.

Example configuration outputs


From the Avity-repository.

Type Example
Red Background and Foreground
Blue Background and Foreground
Rows and Columns
Varied Blue
Varied Red


From the ranvis/identicon-wiki.




Tiles parameter

1 2 3 4 5 6 7 8 9 10

Colors parameter

1 2 3 4 5 6 7 8 9 10


Generating avatars with this plugin takes processing power and uses memory, which - depending on your configuration - will be negligible compared to requesting an external image. Also, when the site is cached the extra load is not noticeable. All images are embedded as Base64 data-URIs, thus reducing internal HTTP requests and the dependency on the external request from Gravatar. All users will also automatically get their own avatar, which is not the case with Gravatar.

The plugin overrides the image source for Gravatar in the navigation-bar and on the userinfo-page, as well as CSS that overrides the border-radius for these images. The range-field, used by forms to provide a slider to select a value, is overridden to show what value is selected.

MIT License 2017 by Ole Vik.