Generate unique SVG avatars

Using boring avatars, easily embed unique SVG-based avatars based on usernames, emails, or any other string.

This service is 100% free and open source, and does not log any information.

Usage

Simply embed the URL in an image tag, followed by any options as query parameters.

<img src="https://boringavatarsapi.hkom.org/{STRING}.svg" />

Options

Variant

Use the variant option to change the avatar style. Available values are marble, beam, pixel, sunset, ring, and bauhaus.

<img src="https://boringavatarsapi.hkom.org/{STRING}.svg?variant=sunset" />

Colors

Use the colors option to set a custom color palette. Pass up to 5 comma-separated hex colors, with or without #.

<img src="https://boringavatarsapi.hkom.org/{STRING}.svg?colors=FF0000,00FF00,0000FF,FFFF00,FF00FF" />

Square

Use the square option to render the avatar as a square instead of a circle. Accepts true or 1.

<img src="https://boringavatarsapi.hkom.org/{STRING}.svg?square=true" />

Size

Use the size option to set the width and height of the avatar in pixels. Defaults to 64.

<img src="https://boringavatarsapi.hkom.org/{STRING}.svg?size=128" />