Skip to main content
Generated variants return the same image for the same seed and options. Portraits are stable for the same seed and gender within the current catalog. Catalog updates are infrequent, but can remap a seed.

Variants

Compare the four avatar styles below, then try them in the live preview above.

Usage

Props

string
required
The seed prop is hashed to select the generated design or catalog portrait; reuse it to keep an avatar stable. Example: customer-123.
Seeds may be logged or cached. Never use sensitive data.
"identicon" | "gradient" | "monogram" | "portrait"
default:"monogram"
The variant prop chooses the visual strategy used to produce the avatar: identicon, gradient, monogram, or portrait. Example: portrait selects a catalog photo.
"any" | "male" | "female"
default:"any"
For portraits, the gender prop limits catalog selection; any uses the full catalog, and the prop does not apply to generated variants. Example: female limits selection to female portraits.
"jpg" | "png" | "webp" | "svg"
default:"svg; portrait: webp"
The format prop controls how the avatar src is encoded; generated variants support SVG and raster output, while portraits are raster-only. Example: webp requests a WebP source.
integer
default:"256"
The size prop requests an exact square raster source. Display dimensions remain controlled by width, height, or CSS. Accepted range: 16-1024. Example: 256.