A Laravel Gravatar package for retrieving gravatar image URLs or checking the existance of an image.

v1.0.24 2024-02-28 09:23 UTC


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]);