Separate by design
Bootstrap Icons is a companion project with its own version and license. It is not part of Bootstrap’s core CSS, is not compiled into versa.css, and does not create a fifth Versa customization layer.
The full Versa package includes Bootstrap Icons 1.13.1 under assets/vendor/bootstrap-icons so downloaded templates work immediately. Projects that do not use icons can remove the stylesheet and font files.
Installation
Bundled local files
Recommended for the complete downloadable Versa package:
<link href="/assets/vendor/bootstrap-icons/bootstrap-icons.min.css" rel="stylesheet">CDN
Projects may load the same independently versioned package from a CDN:
<link href="https://cdn.jsdelivr.net/npm/bootstrap-icons@1.13.1/font/bootstrap-icons.min.css" rel="stylesheet">npm
npm install bootstrap-iconsLoad the icon stylesheet after Bootstrap and before Versa. The icon dependency remains outside the Bootstrap → Versa → Theme → Custom design-layer contract.
Basic usage
Bootstrap Icons inherit the surrounding text color through currentColor, so they naturally follow Versa’s Light, Dark and Auto modes.
<i class="bi bi-star-fill" aria-hidden="true"></i>Decorative star icon
<button class="btn btn-primary" type="button">
<i class="bi bi-download" aria-hidden="true"></i>
Download
</button>Common UI icons
Accessibility
Hide decorative icons from assistive technology with aria-hidden="true". When visible text already names the action, the icon should remain decorative.
Give every icon-only control an accessible name:
<button class="btn btn-primary" type="button" aria-label="Search">
<i class="bi bi-search" aria-hidden="true"></i>
</button>Do not communicate status or meaning with an icon alone. Pair it with visible text or a programmatic label, and preserve sufficient foreground contrast in every color mode.
Replacing the library
Versa does not require Bootstrap Icons for its layout, Theme API or core component styling. A project can remove the Bootstrap Icons stylesheet and use another icon system, but any bi elements in templates must be replaced with that system’s markup.
Keep replacement-library rules in the vendor or project layer—never copy them into versa.css or a token-only theme file.
Full catalog
Browse the official Bootstrap Icons catalog (opens in a new tab) to find every available glyph and its class name.