# NumberCountUp

Source: https://lumeo.nativ.sh/components/number-count-up

# NumberCountUp

Animates a number from a start value to a target with thousands separators, decimal places, and prefix/suffix support. Ideal for stat counters and KPI widgets.

## When to Use

-   Dashboard KPI counters: "1,240,000 users".
-   Stat sections on landing pages: "$4.2M raised", "99.9% uptime".
-   Fundraiser or progress meters with live count-up on mount.

Preview Code

Currency & Units

$972,160

Revenue

88.6%

Uptime

3,366K

Users

Copy Code

Preview Code

Custom Separator

1.176.000

Copy Code

## API Reference

### NumberCountUp

Property

Type

Default

Description

Value

double

0

Target value to count up to.

StartValue

double

0

Starting value for the animation.

DurationMs

int

1500

Animation duration in milliseconds.

Decimals

int

0

Number of decimal places.

Prefix

string?

null

Prefix displayed before the number (e.g. "$").

Suffix

string?

null

Suffix displayed after the number (e.g. "%", "K").

ThousandsSeparator

string

","

Thousands group separator character.

## Related Components

-   [NumberTicker](/components/number-ticker) — Simple digit-by-digit number animation.
-   [AnimatedCircularProgressBar](/components/animated-circular-progress-bar) — SVG ring progress indicator.