Icons sizing
OUDS Web includes some utility classes to change the icons' size.
On this page
For global guidance and suggestions for using icons library with OUDS Web, please see the icons page in foundation documentation.
Icons’ size depends on where they are placed in the page content, so please make sure to either use our utilities provided in this page or follow the design. Icons size utility classes are designed to be used upon <img />, <svg> or even icon font, wherever the icon is.
Every icon size utility class presented in here has the common following code:
%icon-size {
flex-shrink: 0;
width: 1em;
height: 1em;
line-height: 1;
fill: currentcolor;
}
Heading
Here are the rules to follow for headings. These icons’ sizes are responsive.
See the sizes associated to classes
| Icon class | Values from 2xs to sm | Values from md to lg | Values for xl and upper |
|---|---|---|---|
.hxl-large-icon | 2.75rem (44px) | 3.25rem (52px) | 3.75rem (60px) |
.hxl-medium-icon | 2.5rem (40px) | 3rem (48px) | 3.5rem (56px) |
.hxl-small-icon | 2.25rem (36px) | 2.75rem (44px) | 3.25rem (52px) |
.hl-large-icon | 2.5rem (40px) | 2.75rem (44px) | 3.25rem (52px) |
.hl-medium-icon | 2.25rem (36px) | 2.5rem (40px) | 3rem (48px) |
.hl-small-icon | 2rem (32px) | 2.25rem (36px) | 2.75rem (44px) |
.hm-large-icon | 2rem (32px) | 2.5rem (40px) | 2.75rem (44px) |
.hm-medium-icon | 1.75rem (28px) | 2.25rem (36px) | 2.5rem (40px) |
.hm-small-icon | 1.5rem (24px) | 2rem (32px) | 2.25rem (36px) |
.hs-large-icon | 2rem (32px) | 2rem (32px) | 2.5rem (40px) |
.hs-medium-icon | 1.75rem (28px) | 1.75rem (28px) | 2.25rem (36px) |
.hs-small-icon | 1.5rem (24px) | 1.5rem (24px) | 2rem (32px) |
.bl-large-icon | 1.75rem (28px) | 1.75rem (28px) | 2rem (32px) |
.bl-medium-icon | 1.5rem (24px) | 1.5rem (24px) | 1.75rem (28px) |
.bl-small-icon | 1.25rem (20px) | 1.25rem (20px) | 1.5rem (24px) |
.bm-large-icon | 1.5rem (24px) | 1.5rem (24px) | 1.75rem (28px) |
.bm-medium-icon | 1.25rem (20px) | 1.25rem (20px) | 1.5rem (24px) |
.bm-small-icon | 1rem (16px) | 1rem (16px) | 1.25rem (20px) |
H1 with large icon
H1 with medium icon
H1 with small icon
H2 with large icon
H2 with medium icon
H2 with small icon
H3 with large icon
H3 with medium icon
H3 with small icon
H4 with large icon
H4 with medium icon
H4 with small icon
H5 with large icon
H5 with medium icon
H5 with small icon
H6 with lg icon
H6 with medium icon
H6 with small icon
<!-- h1 uses heading-xlarge font reference like all related classes as `.h1`, `.fs-hxl`, etc... -->
<div class="d-flex align-items-center mb-medium">
<svg class="hxl-large-icon me-scaled-small text-status-info" width="1rem" height="1rem" fill="currentColor" aria-hidden="true">
<use xlink:href="/orange/docs/1.6/assets/img/ouds-web-sprite.svg#internet" />
</svg>
<h1 class="mb-none">H1 with large icon</h1>
</div>
<div class="d-flex align-items-center mb-medium">
<svg class="hxl-medium-icon me-scaled-small text-status-info" width="1rem" height="1rem" fill="currentColor" aria-hidden="true">
<use xlink:href="/orange/docs/1.6/assets/img/ouds-web-sprite.svg#internet" />
</svg>
<h1 class="mb-none">H1 with medium icon</h1>
</div>
<div class="d-flex align-items-center mb-medium">
<svg class="hxl-small-icon me-scaled-small text-status-info" width="1rem" height="1rem" fill="currentColor" aria-hidden="true">
<use xlink:href="/orange/docs/1.6/assets/img/ouds-web-sprite.svg#internet" />
</svg>
<h1 class="mb-none">H1 with small icon</h1>
</div>
<hr />
<!-- h2 uses heading-large font reference like all related classes as `.h2`, `.fs-hl`, etc... -->
<div class="d-flex align-items-center mb-medium">
<svg class="hl-large-icon me-scaled-small text-status-info" width="1rem" height="1rem" fill="currentColor" aria-hidden="true">
<use xlink:href="/orange/docs/1.6/assets/img/ouds-web-sprite.svg#internet" />
</svg>
<h2 class="mb-none">H2 with large icon</h2>
</div>
<div class="d-flex align-items-center mb-medium">
<svg class="hl-medium-icon me-scaled-small text-status-info" width="1rem" height="1rem" fill="currentColor" aria-hidden="true">
<use xlink:href="/orange/docs/1.6/assets/img/ouds-web-sprite.svg#internet" />
</svg>
<h2 class="mb-none">H2 with medium icon</h2>
</div>
<div class="d-flex align-items-center mb-medium">
<svg class="hl-small-icon me-scaled-small text-status-info" width="1rem" height="1rem" fill="currentColor" aria-hidden="true">
<use xlink:href="/orange/docs/1.6/assets/img/ouds-web-sprite.svg#internet" />
</svg>
<h2 class="mb-none">H2 with small icon</h2>
</div>
<hr />
<!-- h3 uses heading-medium font reference like all related classes as é`.h3`, `.fs-hm`, etc... -->
<div class="d-flex align-items-center mb-medium">
<svg class="hm-large-icon me-scaled-small text-status-info" width="1rem" height="1rem" fill="currentColor" aria-hidden="true">
<use xlink:href="/orange/docs/1.6/assets/img/ouds-web-sprite.svg#internet" />
</svg>
<h3 class="mb-none">H3 with large icon</h3>
</div>
<div class="d-flex align-items-center mb-medium">
<svg class="hm-medium-icon me-scaled-small text-status-info" width="1rem" height="1rem" fill="currentColor" aria-hidden="true">
<use xlink:href="/orange/docs/1.6/assets/img/ouds-web-sprite.svg#internet" />
</svg>
<h3 class="mb-none">H3 with medium icon</h3>
</div>
<div class="d-flex align-items-center mb-medium">
<svg class="hm-small-icon me-scaled-small text-status-info" width="1rem" height="1rem" fill="currentColor" aria-hidden="true">
<use xlink:href="/orange/docs/1.6/assets/img/ouds-web-sprite.svg#internet" />
</svg>
<h3 class="mb-none">H3 with small icon</h3>
</div>
<hr />
<!-- h4 uses heading-small font reference like all related classes as `.h4`, `.fs-hs`, etc... -->
<div class="d-flex align-items-center mb-medium">
<svg class="hs-large-icon me-scaled-small text-status-info" width="1rem" height="1rem" fill="currentColor" aria-hidden="true">
<use xlink:href="/orange/docs/1.6/assets/img/ouds-web-sprite.svg#internet" />
</svg>
<h4 class="mb-none">H4 with large icon</h4>
</div>
<div class="d-flex align-items-center mb-medium">
<svg class="hs-medium-icon me-scaled-small text-status-info" width="1rem" height="1rem" fill="currentColor" aria-hidden="true">
<use xlink:href="/orange/docs/1.6/assets/img/ouds-web-sprite.svg#internet" />
</svg>
<h4 class="mb-none">H4 with medium icon</h4>
</div>
<div class="d-flex align-items-center mb-medium">
<svg class="hs-small-icon me-scaled-small text-status-info" width="1rem" height="1rem" fill="currentColor" aria-hidden="true">
<use xlink:href="/orange/docs/1.6/assets/img/ouds-web-sprite.svg#internet" />
</svg>
<h4 class="mb-none">H4 with small icon</h4>
</div>
<hr />
<!-- h5 uses body-large font reference like all related classes as `.h5`, `.fs-bl`, etc... -->
<div class="d-flex align-items-center mb-medium">
<svg class="bl-large-icon me-scaled-small text-status-info" width="1rem" height="1rem" fill="currentColor" aria-hidden="true">
<use xlink:href="/orange/docs/1.6/assets/img/ouds-web-sprite.svg#internet" />
</svg>
<h5 class="mb-none">H5 with large icon</h5>
</div>
<div class="d-flex align-items-center mb-medium">
<svg class="bl-medium-icon me-scaled-small text-status-info" width="1rem" height="1rem" fill="currentColor" aria-hidden="true">
<use xlink:href="/orange/docs/1.6/assets/img/ouds-web-sprite.svg#internet" />
</svg>
<h5 class="mb-none">H5 with medium icon</h5>
</div>
<div class="d-flex align-items-center mb-medium">
<svg class="bl-small-icon me-scaled-small text-status-info" width="1rem" height="1rem" fill="currentColor" aria-hidden="true">
<use xlink:href="/orange/docs/1.6/assets/img/ouds-web-sprite.svg#internet" />
</svg>
<h5 class="mb-none">H5 with small icon</h5>
</div>
<hr />
<!-- h6 uses body-medium font reference like all related classes as `.h6`, `.fs-bm`, etc... -->
<div class="d-flex align-items-center mb-medium">
<svg class="bm-large-icon me-scaled-small text-status-info" width="1rem" height="1rem" fill="currentColor" aria-hidden="true">
<use xlink:href="/orange/docs/1.6/assets/img/ouds-web-sprite.svg#internet" />
</svg>
<h6 class="mb-none">H6 with lg icon</h6>
</div>
<div class="d-flex align-items-center mb-medium">
<svg class="bm-medium-icon me-scaled-small text-status-info" width="1rem" height="1rem" fill="currentColor" aria-hidden="true">
<use xlink:href="/orange/docs/1.6/assets/img/ouds-web-sprite.svg#internet" />
</svg>
<h6 class="mb-none">H6 with medium icon</h6>
</div>
<div class="d-flex align-items-center mb-medium">
<svg class="bm-small-icon me-scaled-small text-status-info" width="1rem" height="1rem" fill="currentColor" aria-hidden="true">
<use xlink:href="/orange/docs/1.6/assets/img/ouds-web-sprite.svg#internet" />
</svg>
<h6 class="mb-none">H6 with small icon</h6>
</div>
Display
You should not use any icon with our display texts, because we prefer to keep the place for the text.
Body
Here are the rules to follow for body texts. These icons’ sizes are responsive.
See the sizes associated to classes
| Icon class | Values from 2xs to sm | Values from md to lg | Values for xl and upper |
|---|---|---|---|
.bl-large-icon | 1.75rem (28px) | 1.75rem (28px) | 2rem (32px) |
.bl-medium-icon | 1.5rem (24px) | 1.5rem (24px) | 1.75rem (28px) |
.bl-small-icon | 1.25rem (20px) | 1.25rem (20px) | 1.5rem (24px) |
.bm-large-icon | 1.5rem (24px) | 1.5rem (24px) | 1.75rem (28px) |
.bm-medium-icon | 1.25rem (20px) | 1.25rem (20px) | 1.5rem (24px) |
.bm-small-icon | 1rem (16px) | 1rem (16px) | 1.25rem (20px) |
.bs-large-icon | 1.25rem (20px) | 1.25rem (20px) | 1.5rem (24px) |
.bs-medium-icon | 1rem (16px) | 1rem (16px) | 1.25rem (20px) |
.bs-small-icon | 0.75rem (12px) | 0.75rem (12px) | 1rem (16px) |
Lead paragraph with large icon
Lead paragraph with medium icon
Lead paragraph with small icon
Default paragraph with large icon
Default paragraph with medium icon
Default paragraph with small icon
Small paragraph with large icon
Small paragraph with medium icon
Small paragraph with small icon
<!-- .lead uses body-large font reference like all related classes as `.lead`, `.fs-bl`, etc... -->
<div class="d-flex align-items-center mb-medium">
<svg class="bl-large-icon me-scaled-small text-status-info" width="1rem" height="1rem" fill="currentColor" aria-hidden="true">
<use xlink:href="/orange/docs/1.6/assets/img/ouds-web-sprite.svg#internet" />
</svg>
<p class="lead mb-none">
Lead paragraph with large icon
</p>
</div>
<div class="d-flex align-items-center mb-medium">
<svg class="bl-medium-icon me-scaled-small text-status-info" width="1rem" height="1rem" fill="currentColor" aria-hidden="true">
<use xlink:href="/orange/docs/1.6/assets/img/ouds-web-sprite.svg#internet" />
</svg>
<p class="lead mb-none">
Lead paragraph with medium icon
</p>
</div>
<div class="d-flex align-items-center mb-medium">
<svg class="bl-small-icon me-scaled-small text-status-info" width="1rem" height="1rem" fill="currentColor" aria-hidden="true">
<use xlink:href="/orange/docs/1.6/assets/img/ouds-web-sprite.svg#internet" />
</svg>
<p class="lead mb-none">
Lead paragraph with small icon
</p>
</div>
<hr />
<!-- default paragraph uses body-medium font reference like all related classes as `.fs-bm`, etc... -->
<div class="d-flex align-items-center mb-medium">
<svg class="bm-large-icon me-scaled-small text-status-info" width="1rem" height="1rem" fill="currentColor" aria-hidden="true">
<use xlink:href="/orange/docs/1.6/assets/img/ouds-web-sprite.svg#internet" />
</svg>
<p class="mb-none">
Default paragraph with large icon
</p>
</div>
<div class="d-flex align-items-center mb-medium">
<svg class="bm-medium-icon me-scaled-small text-status-info" width="1rem" height="1rem" fill="currentColor" aria-hidden="true">
<use xlink:href="/orange/docs/1.6/assets/img/ouds-web-sprite.svg#internet" />
</svg>
<p class="mb-none">
Default paragraph with medium icon
</p>
</div>
<div class="d-flex align-items-center mb-medium">
<svg class="bm-small-icon me-scaled-small text-status-info" width="1rem" height="1rem" fill="currentColor" aria-hidden="true">
<use xlink:href="/orange/docs/1.6/assets/img/ouds-web-sprite.svg#internet" />
</svg>
<p class="mb-none">
Default paragraph with small icon
</p>
</div>
<hr />
<!-- .small paragraph uses body-small font reference like all related classes as `.small`, `.fs-bs`, etc... -->
<div class="d-flex align-items-center mb-medium">
<svg class="bs-large-icon me-scaled-small text-status-info" width="1rem" height="1rem" fill="currentColor" aria-hidden="true">
<use xlink:href="/orange/docs/1.6/assets/img/ouds-web-sprite.svg#internet" />
</svg>
<p class="small mb-none">
Small paragraph with large icon
</p>
</div>
<div class="d-flex align-items-center mb-medium">
<svg class="bs-medium-icon me-scaled-small text-status-info" width="1rem" height="1rem" fill="currentColor" aria-hidden="true">
<use xlink:href="/orange/docs/1.6/assets/img/ouds-web-sprite.svg#internet" />
</svg>
<p class="small mb-none">
Small paragraph with medium icon
</p>
</div>
<div class="d-flex align-items-center mb-medium">
<svg class="bs-small-icon me-scaled-small text-status-info" width="1rem" height="1rem" fill="currentColor" aria-hidden="true">
<use xlink:href="/orange/docs/1.6/assets/img/ouds-web-sprite.svg#internet" />
</svg>
<p class="small mb-none">
Small paragraph with small icon
</p>
</div>
Decorative
Here are the rules to follow for decorative icons. Be careful using these icons’ sizes because they are not responsive, and they are set in px, so they do not scale with text zoom. Check out for more information about accessibility in our documentation.
See the sizes associated to classes
| Icon class | Values |
|---|---|
.decorative-2xlarge-icon | 72px |
.decorative-xlarge-icon | 56px |
.decorative-large-icon | 48px |
.decorative-medium-icon | 40px |
.decorative-small-icon | 32px |
.decorative-xsmall-icon | 24px |
.decorative-2xsmall-icon | 16px |
.decorative-3xsmall-icon | 12px |
.decorative-4xsmall-icon | 10px |
2x-large decorative icon
X-large decorative icon
Large decorative icon
Medium decorative icon
Small decorative icon
X-small decorative icon
2x-small decorative icon
3x-small decorative icon
4x-small decorative icon
<svg class="decorative-2xlarge-icon text-status-info" width="1rem" height="1rem" fill="currentColor" aria-hidden="true"></svg>
<svg class="decorative-xlarge-icon text-status-info" width="1rem" height="1rem" fill="currentColor" aria-hidden="true"></svg>
<svg class="decorative-large-icon text-status-info" width="1rem" height="1rem" fill="currentColor" aria-hidden="true"></svg>
<svg class="decorative-medium-icon text-status-info" width="1rem" height="1rem" fill="currentColor" aria-hidden="true"></svg>
<svg class="decorative-small-icon text-status-info" width="1rem" height="1rem" fill="currentColor" aria-hidden="true"></svg>
<svg class="decorative-xsmall-icon text-status-info" width="1rem" height="1rem" fill="currentColor" aria-hidden="true"></svg>
<svg class="decorative-2xsmall-icon text-status-info" width="1rem" height="1rem" fill="currentColor" aria-hidden="true"></svg>
<svg class="decorative-3xsmall-icon text-status-info" width="1rem" height="1rem" fill="currentColor" aria-hidden="true"></svg>
<svg class="decorative-4xsmall-icon text-status-info" width="1rem" height="1rem" fill="currentColor" aria-hidden="true"></svg>
<img> and font icon
SVG sprite is the preferred choice for flexibility, performance and accessibility, and this is why all our examples use this method but there are other ways to display icons. They should all behave the same thanks to our CSS. If you are experimenting any trouble, feel free to search or fill in a new Github discussion or contact our team.
H1 with large icon
H1 with large icon
<div class="d-flex align-items-center mb-medium">
<img class="hxl-large-icon me-small" alt="" src="/orange/docs/1.6/assets/img/vite.svg" />
<h1 class="mb-none">H1 with large icon</h1>
</div>
<div class="d-flex align-items-center mb-medium">
<span class="hxl-large-icon me-small si si-settings" aria-hidden="true"></span>
<h1 class="mb-none">H1 with large icon</h1>
</div>