<!-- Source: https://www.dicebear.com/recipes/gravatar-default-image/ -->
<!-- Documentation for DiceBear 10.7.0. The complete docs as one file: https://www.dicebear.com/llms-full.txt -->

# DiceBear as Gravatar default avatar

Gravatar shows a default image for everyone without a Gravatar account, and
you can point it at the DiceBear HTTP API, so those people get a friendly
generated avatar instead of the gray silhouette. Gravatar sets a few
conditions for default images:

> 1. ✅ MUST be publicly available (e.g. cannot be on an intranet, on a local
>    development machine, behind HTTP Auth or some other firewall etc). Default
>    images are passed through a security scan to avoid malicious content.
> 2. ✅ MUST be accessible via HTTP or HTTPS on the standard ports, 80 and 443,
>    respectively.
> 3. ⚠️ MUST have a recognizable image extension (jpg, jpeg, gif, png, heic)
> 4. ⚠️ MUST NOT include a querystring (if it does, it will be ignored)

> Source: https://docs.gravatar.com/sdk/images/#default-image

Since Gravatar does not support SVG, we have to use the PNG endpoint.

```js [JavaScript]
const emailHash = encodeURIComponent('00000000000000000000000000000000');
const defaultImage = encodeURIComponent(
  'https://api.dicebear.com/10.x/lorelei/svg'
  'https://api.dicebear.com/10.x/lorelei/png'
);

const gravatarImage = `https://www.gravatar.com/avatar/${emailHash}?d=${defaultImage}`;
// https://www.gravatar.com/avatar/00000000000000000000000000000000?d=https%3A%2F%2Fapi.dicebear.com%2F10.x%2Florelei%2Fpng
```

```php [PHP]
$emailHash = urlencode('00000000000000000000000000000000');
$defaultImage = urlencode(
  'https://api.dicebear.com/10.x/lorelei/svg'
  'https://api.dicebear.com/10.x/lorelei/png'
);

$gravatarImage = sprintf(
  'https://www.gravatar.com/avatar/%s?d=%s',
  $emailHash,
  $defaultImage
);
// https://www.gravatar.com/avatar/00000000000000000000000000000000?d=https%3A%2F%2Fapi.dicebear.com%2F10.x%2Florelei%2Fpng
```

```python [Python]
import urllib.parse

email_hash = urllib.parse.quote("00000000000000000000000000000000")
default_image = urllib.parse.quote(
    "https://api.dicebear.com/10.x/lorelei/svg"
    "https://api.dicebear.com/10.x/lorelei/png"
)

gravatar_image = f"https://www.gravatar.com/avatar/{email_hash}?d={default_image}"
# https://www.gravatar.com/avatar/00000000000000000000000000000000?d=https%3A%2F%2Fapi.dicebear.com%2F10.x%2Florelei%2Fpng
```

```go [Go]
import (
	"fmt"
	"net/url"
)

emailHash := url.QueryEscape("00000000000000000000000000000000")
defaultImage := url.QueryEscape(
	"https://api.dicebear.com/10.x/lorelei/svg",
	"https://api.dicebear.com/10.x/lorelei/png",
)

gravatarImage := fmt.Sprintf("https://www.gravatar.com/avatar/%s?d=%s", emailHash, defaultImage)
// https://www.gravatar.com/avatar/00000000000000000000000000000000?d=https%3A%2F%2Fapi.dicebear.com%2F10.x%2Florelei%2Fpng
```

```dart [Dart]
final emailHash = Uri.encodeComponent('00000000000000000000000000000000');
final defaultImage = Uri.encodeComponent(
  'https://api.dicebear.com/10.x/lorelei/svg'
  'https://api.dicebear.com/10.x/lorelei/png'
);

final gravatarImage = 'https://www.gravatar.com/avatar/$emailHash?d=$defaultImage';
// https://www.gravatar.com/avatar/00000000000000000000000000000000?d=https%3A%2F%2Fapi.dicebear.com%2F10.x%2Florelei%2Fpng
```

```csharp [C#]
var emailHash = Uri.EscapeDataString("00000000000000000000000000000000");
var defaultImage = Uri.EscapeDataString(
    "https://api.dicebear.com/10.x/lorelei/svg"
    "https://api.dicebear.com/10.x/lorelei/png"
);

var gravatarImage = $"https://www.gravatar.com/avatar/{emailHash}?d={defaultImage}";
// https://www.gravatar.com/avatar/00000000000000000000000000000000?d=https%3A%2F%2Fapi.dicebear.com%2F10.x%2Florelei%2Fpng
```

Usually we set options in the query string, such as the seed. Since a query
string is not allowed by Gravatar, the [HTTP-API](https://www.dicebear.com/integrations/http-api/) allows
you to specify the options in the path. Just replace the question mark with a
slash and encode the options.

```js [JavaScript]
const emailHash = encodeURIComponent('00000000000000000000000000000000');
const options = `seed=${emailHash}`;
const defaultImage = encodeURIComponent(
  `https://api.dicebear.com/10.x/lorelei/png?${options}`
  `https://api.dicebear.com/10.x/lorelei/png/${encodeURIComponent(options)}`,
);

const gravatarImage = `https://www.gravatar.com/avatar/${emailHash}?d=${defaultImage}`;
// https://www.gravatar.com/avatar/00000000000000000000000000000000?d=https%3A%2F%2Fapi.dicebear.com%2F10.x%2Florelei%2Fpng%2Fseed%253D00000000000000000000000000000000
```

```php [PHP]
$emailHash = urlencode('00000000000000000000000000000000');
$options = sprintf('seed=%s', $emailHash);
$defaultImage = urlencode(
  'https://api.dicebear.com/10.x/lorelei/png?' . $options
  'https://api.dicebear.com/10.x/lorelei/png/' . urlencode($options)
);

$gravatarImage = sprintf(
  'https://www.gravatar.com/avatar/%s?d=%s',
  $emailHash,
  $defaultImage
);
// https://www.gravatar.com/avatar/00000000000000000000000000000000?d=https%3A%2F%2Fapi.dicebear.com%2F10.x%2Florelei%2Fpng%2Fseed%253D00000000000000000000000000000000
```

```python [Python]
import urllib.parse

email_hash = urllib.parse.quote("00000000000000000000000000000000")
options = f"seed={email_hash}"
default_image = urllib.parse.quote(
    f"https://api.dicebear.com/10.x/lorelei/png?{options}"
    f"https://api.dicebear.com/10.x/lorelei/png/{urllib.parse.quote(options)}"
)

gravatar_image = f"https://www.gravatar.com/avatar/{email_hash}?d={default_image}"
# https://www.gravatar.com/avatar/00000000000000000000000000000000?d=https%3A%2F%2Fapi.dicebear.com%2F10.x%2Florelei%2Fpng%2Fseed%253D00000000000000000000000000000000
```

```go [Go]
import (
	"fmt"
	"net/url"
)

emailHash := url.QueryEscape("00000000000000000000000000000000")
options := fmt.Sprintf("seed=%s", emailHash)
defaultImage := url.QueryEscape(
	fmt.Sprintf("https://api.dicebear.com/10.x/lorelei/png?%s", options),
	fmt.Sprintf("https://api.dicebear.com/10.x/lorelei/png/%s", url.QueryEscape(options)),
)

gravatarImage := fmt.Sprintf("https://www.gravatar.com/avatar/%s?d=%s", emailHash, defaultImage)
// https://www.gravatar.com/avatar/00000000000000000000000000000000?d=https%3A%2F%2Fapi.dicebear.com%2F10.x%2Florelei%2Fpng%2Fseed%253D00000000000000000000000000000000
```

```dart [Dart]
final emailHash = Uri.encodeComponent('00000000000000000000000000000000');
final options = 'seed=$emailHash';
final defaultImage = Uri.encodeComponent(
  'https://api.dicebear.com/10.x/lorelei/png?$options'
  'https://api.dicebear.com/10.x/lorelei/png/${Uri.encodeComponent(options)}'
);

final gravatarImage = 'https://www.gravatar.com/avatar/$emailHash?d=$defaultImage';
// https://www.gravatar.com/avatar/00000000000000000000000000000000?d=https%3A%2F%2Fapi.dicebear.com%2F10.x%2Florelei%2Fpng%2Fseed%253D00000000000000000000000000000000
```

```csharp [C#]
var emailHash = Uri.EscapeDataString("00000000000000000000000000000000");
var options = $"seed={emailHash}";
var defaultImage = Uri.EscapeDataString(
    $"https://api.dicebear.com/10.x/lorelei/png?{options}"
    $"https://api.dicebear.com/10.x/lorelei/png/{Uri.EscapeDataString(options)}"
);

var gravatarImage = $"https://www.gravatar.com/avatar/{emailHash}?d={defaultImage}";
// https://www.gravatar.com/avatar/00000000000000000000000000000000?d=https%3A%2F%2Fapi.dicebear.com%2F10.x%2Florelei%2Fpng%2Fseed%253D00000000000000000000000000000000
```