---
title: 'v5.0'
description: 'October, 30. 2019'
version: 11.2.2
generatedAt: 2026-05-11T08:17:53.857Z
checksum: 090b7d977ba4be5e2c4c04d199a30a4048416c59f443a56985df2f80629d9c40
---

# v5

- [Migration](#migration)
- [Typography preparations](#typography-preparations) **(feature)**
- [Number component](#number-component) **(feature)**
- [Color changes](#color-changes) **(major change)**
- [Icon changes](#icon-changes) **(major change)**
- [ESM module format](#esm-module-format) **(major change)**
- [UMD changes](#umd-changes) **(major change)**
- [How to Install](#install)

## Migration

v5 contains a couple of breaking changes. As a migration process, you can simply search your application for:

- find `save_alt_01` and replace if with `save`
- find `--color-cherry-red` or `--color-cherry-red-8` and replace it with `--color-fire-red` and `--color-fire-red-8`
- find `dnb-ui-lib-icons.min.js` and replace it with `dnb-ui-icons.min.js`

## Typography preparations

Soon we will have our own _DNB font_. This will have impact on both, `font-family`, `font-size`, `font-weight` and `line-height`.

To get prepared for these changes, you can today already (since `v4.24`) use the now exposed properties for both:

- [font-size](/uilib/typography/font-size)
- [line-heigh](/uilib/typography/line-height)

From before we had [font-weight](/uilib/typography/font-weight).

Read more on how to make CSS vars (Custom Properties) [work on IE](/uilib/usage/customisation/styling/polyfill).

### The benefits?

If you are using only properties to change actively your application typography, then a future update with changes will "automatically" happen, so you don't need to make manual code changes later.

### Properties as JS

You can now also import all the main properties as a [JavaScript Object](/uilib/usage/customisation/styling/polyfill#css-in-js):

```js
import properties from 'dnb-ui-lib/style/properties
```

## Number component

The new [Number component](/uilib/components/number) is a ready to use DNB number formatter. Use it where over you have to display a number, a currency value, phone number, etc.

Good reasons for why we have this is to:

- uniform the formation of numbers for all DNB applications.
- and make numbers accessible to screen readers.

## Color changes

- _Cherry Red_ will got replaced by _Fire Red_.
- _Cherry Red 8%_ will got replaced by _Fire Red 8%_.

You may check your application code and **replace** `cherry-red` with `fire-red`.

```css
/* New */
color: var(--color-fire-red);
color: var(--color-fire-red-8);

/* Deprecated */
color: var(--color-cherry-red);
color: var(--color-cherry-red-8);
```

## Icon changes

```js
/* New */
import { download } from 'dnb-ui-lib/icons/secondary'

/* Removed */
import { error } from 'dnb-ui-lib/icons/primary'
import { save_alt_01 } from 'dnb-ui-lib/icons/secondary'
```

## ESM module format

The `dnb-ui-lib` uses now `ESM` as the default module format. But every component is still compiled down to ES5.

### Do I have to make changes?

**Mostly likely no**. The majority of applications / projects does not to have to make changes.

If you are in **Node.js** (SSR) land, [read more about CJS](/uilib/usage/first-steps/module-formats#commonjs-cjs).

### What is ESM good for?

Your project is most likely already using `ESM` (import / export). Now that the `dnb-ui-lib` uses `ESM`, [tree shaking](/uilib/usage/first-steps/module-formats) is much easier to handle and most likely be handled out of the box by your application bundler of choice (e.g. [webpack](https://webpack.js.org) ([create-react-app](https://github.com/facebook/create-react-app)), [rollup.js](https://rollupjs.org/guide/en/) and [parcel.js](https://parceljs.org)).

## UMD changes

The `UMD` package for icons `dnb-ui-lib-icons.min.js` got a new naming:

- `dnb-ui-icons.min.js`

## Install

To upgrade to v5 with NPM, use:

```bash
$ npm i dnb-ui-lib@5
```

_October, 30. 2019_