Skip to content
DocumentationExamples
Optional vendor companion

Icons

Versa includes Bootstrap Icons in the full download for convenience while keeping the library separate, optional and independently upgradeable.

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-icons

Load 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

bi-house
bi-search
bi-person
bi-gear
bi-check-circle
bi-arrow-right
bi-envelope
bi-calendar
bi-download
bi-upload
bi-play-circle
bi-info-circle

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.