`<wa-icon>`

Icons are scalable vector symbols that represent actions, content, or status throughout your application. They support Font Awesome and custom icon libraries with animation presets.

Category: Media
Built with: Lit
Library: Web Awesome
Author: Web Awesome
Package: @awesome.me/webawesome
Component size: 17.0 kB JS (minified + gzipped, JS includes dependencies beyond the library)
Library size: 8.2 kB JS (shared by every Web Awesome component, loaded once per page)
Popular: 5 out of 5
Downloads: 364,100/week · jsDelivr 33,855,650 hits/month (whole @awesome.me/webawesome package)
GitHub stars: 1,348
Latest stable version: 3.14.0
Last published: Sep 24, 2026
Component last changed: Apr 3, 2026 (in 3.5.0)
License: MIT
Status: stable

Documentation
Demo
Source code

Attributes

name
family
variant
canvas
auto-width
swap-opacity
src
label
library
rotate
flip
animation
dir
lang
did-ssr

Events

wa-load
wa-error

CSS Parts

svg
use