NV NVIDIA Elements Catalog Starters Repo System Themes Getting Started Getting Started Installation CLI MCP Skills Lint Integrations Getting Started Angular Bundles CDN Custom Elements Eleventy Golang HTMX + Go Hugo Import Maps Lit Lit Library MCP Apps NextJS Nuxt Preact React SolidJS Svelte TypeScript Vue About What’s New Changelog Metrics Support Accessibility Contributions Requests Migration Foundations Overview Typography Iconography Themes Design Tokens Size & Space Objects Interactions Support Status Color Animation Fonts Layers Custom Layout Horizontal Vertical Grid Popovers i18n Visualization View Transitions DESIGN.md Elements Accordion Alert Avatar Badge Breadcrumb Button Button Group Card Chat Message Checkbox Codeblock Color Combobox Copy Button Datagrid Integrations Column Action Column Alignment Column Fixed Column width Container Card Display Settings Footer Heatmap Keynav Multi Select Pagination Panel Detail Panel Grid Performance Placeholder Row Action Row Groups Row Sort Scroll Height Single Select Stripe Date Datetime Dialog Divider Dot Drawer Dropdown Dropdown Group Dropzone File Format Bytes Format Datetime Format Number Format Relative Time Forms Validation Actions Control Gauge Icon Icon Button Input Input Group Logo Markdown Markdown CSS Media Controller Media Pause Button Media Playback Rate Select Media Mute Button Media Seek Button Media Time Range Media Volume Range Media Full-screen Button Menu Month Monaco Input Monaco Diff Input Monaco Editor Monaco Diff Editor Monaco Problems Notification Page Page Header Page Loader Pagination Progressive Filter Chip Progress Bar Progress Ring Password Preferences Input Pulse Radio Range Resize Handle Search Select Skeleton Sort Button Sparkline Star Rating Steps Switch Tabs Tag Textarea Time Toast Toggletip Toolbar Tooltip Tree Week Patterns Authentication Browse Chat Dashboard Editor Empty States Heatmap Keyboard Shortcut Logging Media Navigation Onboarding Panel Responsive Search Subheader Trend Labs Responsive Layout Viewport Container Patterns Forms API Design Properties & Attributes Slots Registration CustomEvents Stateless Composition Styles Packaging Glossary Logs Internal Guidelines Agent Harness Agent Tooling Agent Ownership Documentation Examples TypeScript Testing Unit Testing Accessibility Testing Lighthouse Testing SSR Testing Visual Testing Troubleshooting Component Creation Internal Examples All Examples

Format Bytes

stable:  2.3.0 Coverage: 94.00% Bundle: 10kb Lighthouse: 100 Axe Core Released: 0.0.0
Overview API Examples

Formats a byte count as localized, human-readable decimal or binary units.

1024 1048576 1073741824

Installation

CLI / MCP / CDN

Format Bytes converts byte counts into readable decimal or binary units. Supply the byte count as text content to provide an SSR fallback, or set the value property or attribute for JavaScript and bound data. If both are present, value takes precedence.

The locale property controls number formatting. Unit labels remain lowercase English strings in every locale.

Default

Automatic decimal conversion for concise file sizes and storage metrics. The component selects the appropriate unit from the byte count.

1024 1048576 1073741824

Unit

Forced unit magnitudes for comparing byte counts on a consistent scale. Use when values need the same unit across a table or chart.

1048576 1048576 1048576

Unit Display

Short and long unit labels for compact metrics or explanatory text. Long labels improve clarity when space allows.

1048576 1048576 1048576

Precision

Fraction digit controls for matching the precision of storage measurements. Use fixed digits when values must align visually.

1234567 1234567 1234567

Locale

Explicit locale formatting for audiences whose numeric separators differ from the document language. Unit labels remain lowercase English.

1048576 1048576 1048576

Value

Value attribute input for JavaScript or bound data. It takes precedence over text content while the text remains an SSR fallback.

1024

Display

Decimal and binary conversion for matching SI or IEC storage conventions. Use the convention expected by the surrounding product.

1024 1024

Release Status

All elements and features go through 3 phases of stability, pre-release, beta and stable.

pre-release
Docs Preview API Documentation Fully Themeable
beta
Robust unit test coverages Passed API Review Passed Designer VQA Review Included in library package
stable
No known outstanding AA WCAG issues No known outstanding performance issues Adapts to different screen/container sizes No breaking API changes for at least 90 days