# DynamicIcon

Source: https://lumeo.nativ.sh/components/dynamic-icon

# DynamicIcon

A docs utility component that renders icons by name and automatically adapts to the active icon library selected in the Customizer.

Preview Code

Basic Usage

## All Supported Icons

Switch the icon library in the Customizer to see all icons update live.

Accessibility

AlignCenter

AlignLeft

AlignRight

Archive

ArrowDown

ArrowLeft

ArrowRight

ArrowUp

BarChart3

Bell

BellOff

Blocks

Bold

Box

Calendar

CalendarDays

Camera

ChartBar

Check

CheckCheck

CheckSquare

ChevronDown

ChevronLeft

ChevronRight

ChevronUp

ChevronsUpDown

CircleAlert

CircleCheck

CircleDot

ClipboardList

Clipboard

Code

Columns3

Copy

Disc

Download

Ellipsis

ExternalLink

Eye

FileText

Flag

FolderOpen

Github

Globe

Heart

Home

House

Image

Inbox

Info

Italic

LayoutDashboard

LayoutGrid

LayoutTemplate

List

ListMusic

Loader

LoaderCircle

Lock

LogIn

LogOut

Mail

Menu

MessageCircle

MessageSquare

Mic

Minus

Moon

MousePointerClick

Music

Package

Paintbrush

Palette

PanelRightClose

PanelRightOpen

Pause

Pencil

Phone

Pin

Play

Plus

Radio

RefreshCw

RotateCcw

Search

SearchX

Send

Settings

Share

Share2

Shield

ShieldCheck

SkipBack

SkipForward

Slash

Smartphone

Star

Sun

Tag

Trash

Trash2

TrendingUp

TriangleAlert

Underline

Upload

User

UserPlus

Users

Volume

Volume1

Volume2

X

Zap

## How It Works

DynamicIcon is a docs-only component that wraps Blazicons and maps abstract icon names to the correct icon in whichever library is currently active. It listens to `IconService.OnChange` and re-renders automatically.

Preview Code

With Colors & Sizes

## API Reference

### DynamicIcon

Prop

Type

Default

Description

Name

string

"Circle"

Abstract icon name (e.g. "Search", "Bell", "Settings"). Mapped to the active icon library.

Class

string?

null

CSS classes for sizing and color (e.g. "h-5 w-5 text-primary").

AdditionalAttributes

Dictionary<string, object>?

null

Additional HTML attributes passed to the underlying Blazicon element.
