<h2>Install</h2><p>Bootstrap Icons are published to npm, but they can also be manually downloaded if needed.</p><h3>Package manager</h3><p>Install <a href="https://www.npmjs.com/package/bootstrap-icons" rel="noopener noreferrer" target="_blank" style="color: rgb(110, 168, 254);">Bootstrap Icons</a>—including SVGs, icon sprite, and icon fonts—with npm or Composer. Then, choose how you’d like to include the icons with the <a href="https://icons.getbootstrap.com/?q=rup#usage" rel="noopener noreferrer" target="_blank" style="color: rgb(110, 168, 254);">usage instructions</a>.</p><p><br></p><pre class="ql-syntax" spellcheck="false">npm i bootstrap-icons
</pre><p><br></p><pre class="ql-syntax" spellcheck="false">composer require twbs/bootstrap-icons
</pre><h3>Download</h3><p><a href="https://github.com/twbs/icons/releases/" rel="noopener noreferrer" target="_blank" style="color: rgb(110, 168, 254);">Releases are published on GitHub</a> and include icon SVGs, fonts, license, and readme. Our <code style="color: rgb(230, 133, 181);">package.json</code> is also included, though our npm scripts are primarily available for our development workflows.</p><h3>CDN</h3><p>Include the icon fonts stylesheet—in your website <code style="color: rgb(230, 133, 181);"><head></code> or via <code style="color: rgb(230, 133, 181);">@import</code> in CSS—from jsDelivr and get started in seconds. <a href="https://icons.getbootstrap.com/?q=rup#icon-font" rel="noopener noreferrer" target="_blank" style="color: rgb(110, 168, 254);">See icon font docs</a> for examples.</p><p><br></p><pre class="ql-syntax" spellcheck="false"><link rel="stylesheet" href="https://cdn.jsdelivr.net/npm/bootstrap-icons@1.13.1/font/bootstrap-icons.min.css">
</pre><p><br></p><pre class="ql-syntax" spellcheck="false">@import url("https://cdn.jsdelivr.net/npm/bootstrap-icons@1.13.1/font/bootstrap-icons.min.css");
</pre><h2>Usage</h2><p>Bootstrap Icons are SVGs, so you can include them into your HTML in a few ways depending on how your project is setup. We recommend using a <code style="color: rgb(230, 133, 181);">width: 1em</code> (and optionally <code style="color: rgb(230, 133, 181);">height: 1em</code>) for easy resizing via <code style="color: rgb(230, 133, 181);">font-size</code>.</p><h3>Embedded</h3><p>Embed your icons within the HTML of your page (as opposed to an external image file). Here we’ve used a custom <code style="color: rgb(230, 133, 181);">width</code> and <code style="color: rgb(230, 133, 181);">height</code>.</p><p><br></p><p><br></p><pre class="ql-syntax" spellcheck="false"><svg xmlns="http://www.w3.org/2000/svg" width="16" height="16" fill="currentColor" class="bi bi-emoji-heart-eyes" viewBox="0 0 16 16"><path d="M8 15A7 7 0 1 1 8 1a7 7 0 0 1 0 14zm0 1A8 8 0 1 0 8 0a8 8 0 0 0 0 16z"/><path d="M11.315 10.014a.5.5 0 0 1 .548.736A4.498 4.498 0 0 1 7.965 13a4.498 4.498 0 0 1-3.898-2.25.5.5 0 0 1 .548-.736h.005l.017.005.067.015.252.055c.215.046.515.108.857.169.693.124 1.522.242 2.152.242.63 0 1.46-.118 2.152-.242a26.58 26.58 0 0 0 1.109-.224l.067-.015.017-.004.005-.002zM4.756 4.566c.763-1.424 4.02-.12.952 3.434-4.496-1.596-2.35-4.298-.952-3.434zm6.488 0c1.398-.864 3.544 1.838-.952 3.434-3.067-3.554.19-4.858.952-3.434z"/></svg>
</pre><h3>Sprite</h3><p>Use the SVG sprite to insert any icon through the <code style="color: rgb(230, 133, 181);"><use></code> element. Use the icon’s filename as the fragment identifier (e.g., <code style="color: rgb(230, 133, 181);">toggles</code> is <code style="color: rgb(230, 133, 181);">#toggles</code>). SVG sprites allow you to reference an external file similar to an <code style="color: rgb(230, 133, 181);"><img></code> element, but with the power of <code style="color: rgb(230, 133, 181);">currentColor</code> for easy theming.</p><p><strong>Heads up!</strong> There’s an issue with Chrome where <code style="color: rgb(110, 168, 254);"><a href="https://bugs.chromium.org/p/chromium/issues/detail?id=470601" rel="noopener noreferrer" target="_blank"><use></a></code><a href="https://bugs.chromium.org/p/chromium/issues/detail?id=470601" rel="noopener noreferrer" target="_blank" style="color: rgb(110, 168, 254);"> doesn’t work across domains</a>.</p>