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."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.