Icons
Icons is a geometric vector avatar style built from simple, recognizable icon shapes. Generate clean, scalable customizable profile icons ideal for dashboards, admin panels, and enterprise tools.
This avatar style is based on: Bootstrap Icons by The Bootstrap Authors, licensed under MIT .
Open in PlaygroundUsage
Use this URL to request this avatar style via our HTTP API.
https://api.dicebear.com/9.x/icons/svg
You can use the URL directly as image source.
See HTTP-API docs for more information.
First install the required packages via npm:
npm install @dicebear/core @dicebear/collection --save
Then you can create this avatar as follows:
import { createAvatar } from '@dicebear/core';
import { icons } from '@dicebear/collection';
const avatar = createAvatar(icons, {
// ... options
});
const svg = avatar.toString();
See JS-Library docs for more information.
First install the CLI package via npm:
npm install --global dicebear
Then you can create this avatar as follows:
dicebear icons
See CLI docs for more information.
Options
seed
TypestringThe seed determines the initial value for the built-in PRNG. With the PRNG you can create the same avatar over and over again based.
FelixAnekahttps://api.dicebear.com/9.x/icons/svg?seed=Felix
createAvatar(icons, {
seed: "Felix"
});dicebear icons --seed "Felix"
flip
Typebooleanfalsetruefalsehttps://api.dicebear.com/9.x/icons/svg?flip=false
createAvatar(icons, {
flip: false
});dicebear icons --flip false
rotate
TypeintegerMinimum 0Maximum 3600901802700https://api.dicebear.com/9.x/icons/svg?rotate=0
createAvatar(icons, {
rotate: 0
});dicebear icons --rotate 0
scale
TypeintegerMinimum 0Maximum 20050100200100https://api.dicebear.com/9.x/icons/svg?scale=50
createAvatar(icons, {
scale: 50
});dicebear icons --scale 50
radius
TypeintegerMinimum 0Maximum 50010203040500https://api.dicebear.com/9.x/icons/svg?radius=0
createAvatar(icons, {
radius: 0
});dicebear icons --radius 0
size
TypeintegerMinimum 13248648096https://api.dicebear.com/9.x/icons/svg?size=32
createAvatar(icons, {
size: 32
});dicebear icons --size 32
backgroundColor
TypearrayItem Pattern ^(transparent|[a-fA-F0-9]{6})$b6e3f4c0aeded1d4f9ffd5dcffdfbf9fa8da80cbc480deea81d4fa90caf9a5d6a7b39ddbc5e1a5ce93d8e6ee9cef9a9af48fb1ffab91ffcc80ffe082https://api.dicebear.com/9.x/icons/svg?backgroundColor=b6e3f4,c0aede,d1d4f9
createAvatar(icons, {
backgroundColor: ["b6e3f4","c0aede","d1d4f9"]
});dicebear icons --backgroundColor "b6e3f4" "c0aede" "d1d4f9"
backgroundType
TypearraygradientLinearsolidsolidhttps://api.dicebear.com/9.x/icons/svg?backgroundType=gradientLinear,solid
createAvatar(icons, {
backgroundType: ["gradientLinear","solid"]
});dicebear icons --backgroundType "gradientLinear" "solid"
backgroundRotation
Typearray Specify an array of two numbers for this option. The PRNG will generate a number between the two values, which will be used as the rotation degree. The rotation is only visible if backgroundType is set to ['gradientLinear'].
0360https://api.dicebear.com/9.x/icons/svg?backgroundRotation=0,360
createAvatar(icons, {
backgroundRotation: [0,360]
});dicebear icons --backgroundRotation 0 360
translateX
TypeintegerMinimum -100Maximum 100-50-25025500https://api.dicebear.com/9.x/icons/svg?translateX=-50
createAvatar(icons, {
translateX: -50
});dicebear icons --translateX -50
translateY
TypeintegerMinimum -100Maximum 100-50-25025500https://api.dicebear.com/9.x/icons/svg?translateY=-50
createAvatar(icons, {
translateY: -50
});dicebear icons --translateY -50
clip
Typebooleantruehttps://api.dicebear.com/9.x/icons/svg?clip=true
createAvatar(icons, {
clip: true
});dicebear icons --clip true
randomizeIds
TypebooleanThis option randomize the IDs in the generated SVG / XML. This can be useful for example if the avatars are included directly in the HTML and you want to avoid ID collisions.
falsehttps://api.dicebear.com/9.x/icons/svg?randomizeIds=false
createAvatar(icons, {
randomizeIds: false
});dicebear icons --randomizeIds false
icon
Typearrayalarmarchiveawardbagbandaidbankbasketbasket2basket3bellbicyclebinocularsbookbookshelfboomboxboxboxesboxSeambricksbriefcasebrightnessHighbrushbucketbugbuildingcalculatorcameracameraReelscart2cashCoinclockcloudcloudDrizzlecloudMooncloudscloudSnowcoincompasscontrollercupcupStrawdice5discdisplaydoorCloseddoorOpendpaddropleteaseleggeggFriedemojiHeartEyesemojiLaughingemojiSmileemojiSmileUpsideDownemojiSunglassesemojiWinkenvelopeeyeglassesflagflower1flower2flower3gemgiftglobeglobe2handbaghandThumbsUphddhearthourglasshourglassSplithousehouseDoorinboxinboxeskeykeyboardladderlamplaptoplightbulblightninglightningChargelockmagicmailboxmapmegaphoneminecartminecartLoadedmoonmoonStarsmortarboardmousemouse2newspaperpaintBucketpalettepalette2paperclippenpencilphonepiggyBankpinAngleplugprinterprojectorpuzzlerouterscissorssdCardsearchsendshopshopWindowsignpostsignpost2signpostSplitsmartwatchsnowsnow2snow3speakerstarstoplightsstopwatchsuntabletthermometerticketPerforatedtornadotrashtrash2treetrophytrucktruckFlatbedtsunamiumbrellawalletwallet2watchwebcamalarmarchiveawardbagbandaidbankbasketbasket2basket3bellbicyclebinocularsbookbookshelfboomboxboxboxesboxSeambricksbriefcasebrightnessHighbrushbucketbugbuildingcalculatorcameracameraReelscart2cashCoinclockcloudcloudDrizzlecloudMooncloudscloudSnowcoincompasscontrollercupcupStrawdice5discdisplaydoorCloseddoorOpendpaddropleteaseleggeggFriedemojiHeartEyesemojiLaughingemojiSmileemojiSmileUpsideDownemojiSunglassesemojiWinkenvelopeeyeglassesflagflower1flower2flower3gemgiftglobeglobe2handbaghandThumbsUphddhearthourglasshourglassSplithousehouseDoorinboxinboxeskeykeyboardladderlamplaptoplightbulblightninglightningChargelockmagicmailboxmapmegaphoneminecartminecartLoadedmoonmoonStarsmortarboardmousemouse2newspaperpaintBucketpalettepalette2paperclippenpencilphonepiggyBankpinAngleplugprinterprojectorpuzzlerouterscissorssdCardsearchsendshopshopWindowsignpostsignpost2signpostSplitsmartwatchsnowsnow2snow3speakerstarstoplightsstopwatchsuntabletthermometerticketPerforatedtornadotrashtrash2treetrophytrucktruckFlatbedtsunamiumbrellawalletwallet2watchwebcamhttps://api.dicebear.com/9.x/icons/svg?icon=alarm,archive,award
createAvatar(icons, {
icon: ["alarm","archive","award"]
});dicebear icons --icon "alarm" "archive" "award"
Details
| Naming | |
|---|---|
| Collection Import | import { icons } from '@dicebear/collection'; |
| Package Import | import * as style from '@dicebear/icons'; |
| CLI | dicebear icons |
| HTTP-API | https://api.dicebear.com/9.x/icons/svg |
| JSON Schema | https://api.dicebear.com/9.x/icons/schema.json |
| Source | |
|---|---|
| Title | Bootstrap Icons |
| Creator | The Bootstrap Authors |
| Website | https://getbootstrap.com/ |
| License | MIT |
| Source | https://github.com/twbs/icons |