Skip to content
A Laravel Gravatar package for retrieving gravatar image URLs or checking the existance of an image.
Branch: 1.0
Clone or download
creativeorange Update composer.json
Removed Laravel versions in composer.json description. (It works for all Laravel 5.x versions)
Latest commit e1b1b2d Jun 13, 2019
Type Name Latest commit message Commit time
Failed to load latest commit information.
config initial commit Mar 19, 2015
src Don't use deprecated Laravel helper array_dot() (#20) Jun 3, 2019
.gitignore Updated readme to include Laravel 5.4 instructions Feb 15, 2017
composer.json Update composer.json Jun 13, 2019 Updates readme title Jun 3, 2019

Gravatar for Laravel 5.x

Total Downloads Latest Stable Version License


First, pull in the package through Composer via the command line:

composer require creativeorange/gravatar ~1.0

or add the following to your composer.json file and run composer update.

"require": {
    "creativeorange/gravatar": "~1.0"

Then include the service provider within (Laravel 5.3 or below) app/config/app.php.

'providers' => [

If using Laravel 5.4, include service provider withing config/app.php

'providers' => [

If you want to use the facade, add this to de bottom of app/config/app.php And, for convenience, add a facade alias to this same file at the bottom:

'aliases' => [
    'Gravatar' => 'Creativeorange\Gravatar\Facades\Gravatar',

If you are using Laravel 5.4 or greater, add as follows, add to config/app.php

'aliases' => [
    'Gravatar' => Creativeorange\Gravatar\Facades\Gravatar::class,

Finally, publish the config by running the php artisan vendor:publish command


Within your controllers or views, you can use


this will return the URL to the gravatar image of the specified email address. In case of a non-existing gravatar, it will return return a URL to a placeholder image. You can set the type of the placeholder in the configuration option fallback. For more information, visit

Alternatively, you can check for the existence of a gravatar image by using


This will return a boolean (true or false).

Or you can pass a url to a custom image using the fallback method:



You can create different configuration groups to use within your application and pass the group name as a second parameter to the get-method:

There is a default group in config/gravatar.php which will be used when you do not specify a second parameter.

If you would like to add more groups, feel free to edit the config/gravatar.php file. For example:

return array(
	'default' => array(
		'size'   => 80,
		'fallback' => 'mm',
		'secure' => false,
		'maximumRating' => 'g',
		'forceDefault' => false,
		'forceExtension' => 'jpg',
	'small-secure' => array (
	    'size'   => 30,
	    'secure' => true,
	'medium' => array (
	    'size'   => 150,

then you can use the following syntax:

Gravatar::get('', 'small-secure'); // will use the small-secure group
Gravatar::get('', 'medium'); // will use the medium group
Gravatar::get('', 'default'); // will use the default group
Gravatar::get(''); // will use the default group

Alternatively, you could also pass an array directly as the second parameter as inline options. So, instead of passing a configuration key, you pass an array, which will be merged with the default group:

Gravatar::get('', ['size'=>200]); 
You can’t perform that action at this time.