---
title: Icon link
description: Quickly create stylized hyperlinks with Bootstrap Icons or other icons.
toc: true
added:
  version: "5.3"
---

The icon link helper component modifies our default link styles to enhance their appearance and quickly align any pairing of icon and text. Alignment is set via inline flexbox styling and a default `gap` value. We stylize the underline with a custom offset and color. Icons are automatically sized to `1em` to best match their associated text’s `font-size`.

Icon links assume [Bootstrap Icons](https://icons.getbootstrap.com) are being used, but you can use any icon or image you like.

<Callout>
When icons are purely decorative, they should be hidden from assistive technologies using `aria-hidden="true"`, as we’ve done in our examples. For icons that convey meaning, provide an appropriate text alternative by adding `role="img"` and an appropriate `aria-label="..."` to the SVGs.
</Callout>

## Example

Take a regular `<a>` element, add `.icon-link`, and insert an icon on either the left or right of your link text. The icon is automatically sized, placed, and colored.

<Example code={`
    
    Icon link
  `} />

<Example code={`
    Icon link
    
  `} />

## Style on hover

Add `.icon-link-hover` to move the icon to the right on hover.

<Example code={`
    Icon link
    
  `} />

## Customize

Modify the styling of an icon link with our link CSS variables, Sass variables, utilities, or custom styles.

### CSS variables

Modify the `--bs-link-*` and `--bs-icon-link-*` CSS variables as needed to change the default appearance.

Customize the hover `transform` by overriding the `--bs-icon-link-transform` CSS variable:

<Example code={`
    
    Icon link
  `} />

Customize the color by overriding the `--bs-link-*` CSS variable:

<Example code={`
    Icon link
    
  `} />

### Sass variables

Customize the icon link Sass variables to modify all icon link styles across your Bootstrap-powered project.

<ScssDocs name="icon-link-variables" file="scss/_variables.scss" />

### Sass utilities API

Modify icon links with any of [our link utilities]([[docsref:/utilities/link/]]) for modifying underline color and offset.

<Example code={`
    Icon link
    
  `} />
