A visual indicator that communicates a status description of an associated component. Status badges use short text, color, built in icons for quick recognition and render near the relevant content.
<nve-badge>badge</nve-badge>
badge
Installation
<script type="module">
import '@nvidia-elements/core/badge/define.js';
</script>
<nve-badge>badge</nve-badge>
Status
Badges with predefined status colors for different states. Ideal for showing job status, task progress, or system states.
<div nve-layout="row gap:xs align:wrap">
<nve-badge status="scheduled">scheduled</nve-badge>
<nve-badge status="queued">queued</nve-badge>
<nve-badge status="pending">pending</nve-badge>
<nve-badge status="starting">starting</nve-badge>
<nve-badge status="running">running</nve-badge>
<nve-badge status="restarting">restarting</nve-badge>
<nve-badge status="stopping">stopping</nve-badge>
<nve-badge status="finished">finished</nve-badge>
<nve-badge status="failed">failed</nve-badge>
<nve-badge status="unknown">unknown</nve-badge>
<nve-badge status="ignored">ignored</nve-badge>
</div>
scheduled queued pending starting running restarting stopping finished failed unknown ignored
Support status badges for general feedback states. Use for success, warning, error, or informational messages.
<div nve-layout="row gap:md">
<nve-badge status="accent">accent</nve-badge>
<nve-badge status="warning">warning</nve-badge>
<nve-badge status="success">success</nve-badge>
<nve-badge status="danger">danger</nve-badge>
</div>
accent warning success danger
Flat
Flat container badges with status colors for a more subtle appearance. Perfect for dense layouts or when you want less visual weight.
<div nve-layout="row gap:md align:wrap">
<nve-badge container="flat" status="scheduled">scheduled</nve-badge>
<nve-badge container="flat" status="queued">queued</nve-badge>
<nve-badge container="flat" status="pending">pending</nve-badge>
<nve-badge container="flat" status="starting">starting</nve-badge>
<nve-badge container="flat" status="running">running</nve-badge>
<nve-badge container="flat" status="restarting">restarting</nve-badge>
<nve-badge container="flat" status="stopping">stopping</nve-badge>
<nve-badge container="flat" status="finished">finished</nve-badge>
<nve-badge container="flat" status="failed">failed</nve-badge>
<nve-badge container="flat" status="unknown">unknown</nve-badge>
<nve-badge container="flat" status="ignored">ignored</nve-badge>
</div>
scheduled queued pending starting running restarting stopping finished failed unknown ignored
Icon
Status badges with icons only, using aria-label for accessibility. Useful for compact status indicators in toolbars or data tables.
<div nve-layout="row gap:md align:wrap">
<nve-badge container="flat" status="scheduled" aria-label="scheduled"></nve-badge>
<nve-badge container="flat" status="queued" aria-label="queued"></nve-badge>
<nve-badge container="flat" status="pending" aria-label="pending"></nve-badge>
<nve-badge container="flat" status="starting" aria-label="starting"></nve-badge>
<nve-badge container="flat" status="running" aria-label="running"></nve-badge>
<nve-badge container="flat" status="restarting" aria-label="restarting"></nve-badge>
<nve-badge container="flat" status="stopping" aria-label="stopping"></nve-badge>
<nve-badge container="flat" status="finished" aria-label="finished"></nve-badge>
<nve-badge container="flat" status="failed" aria-label="failed"></nve-badge>
<nve-badge container="flat" status="unknown" aria-label="unknown"></nve-badge>
<nve-badge container="flat" status="ignored" aria-label="ignored"></nve-badge>
</div>
Color
Badges with color variants for categorization and theming. Use for organizing content by color-coded categories.
<div nve-layout="row gap:sm align:wrap">
<nve-badge color="red-cardinal"><nve-icon name="placeholder"></nve-icon> red-cardinal</nve-badge>
<nve-badge color="gray-slate"><nve-icon name="placeholder"></nve-icon> gray-slate</nve-badge>
<nve-badge color="gray-denim"><nve-icon name="placeholder"></nve-icon> gray-denim</nve-badge>
<nve-badge color="blue-indigo"><nve-icon name="placeholder"></nve-icon> blue-indigo</nve-badge>
<nve-badge color="blue-cobalt"><nve-icon name="placeholder"></nve-icon> blue-cobalt</nve-badge>
<nve-badge color="blue-sky"><nve-icon name="placeholder"></nve-icon> blue-sky</nve-badge>
<nve-badge color="teal-cyan"><nve-icon name="placeholder"></nve-icon> teal-cyan</nve-badge>
<nve-badge color="green-mint"><nve-icon name="placeholder"></nve-icon> green-mint</nve-badge>
<nve-badge color="teal-seafoam"><nve-icon name="placeholder"></nve-icon> teal-seafoam</nve-badge>
<nve-badge color="green-grass"><nve-icon name="placeholder"></nve-icon> green-grass</nve-badge>
<nve-badge color="yellow-amber"><nve-icon name="placeholder"></nve-icon> yellow-amber</nve-badge>
<nve-badge color="orange-pumpkin"><nve-icon name="placeholder"></nve-icon> orange-pumpkin</nve-badge>
<nve-badge color="red-tomato"><nve-icon name="placeholder"></nve-icon> red-tomato</nve-badge>
<nve-badge color="pink-magenta"><nve-icon name="placeholder"></nve-icon> pink-magenta</nve-badge>
<nve-badge color="purple-plum"><nve-icon name="placeholder"></nve-icon> purple-plum</nve-badge>
<nve-badge color="purple-violet"><nve-icon name="placeholder"></nve-icon> purple-violet</nve-badge>
<nve-badge color="purple-lavender"><nve-icon name="placeholder"></nve-icon> purple-lavender</nve-badge>
<nve-badge color="pink-rose"><nve-icon name="placeholder"></nve-icon> pink-rose</nve-badge>
<nve-badge color="green-jade"><nve-icon name="placeholder"></nve-icon> green-jade</nve-badge>
<nve-badge color="lime-pear"><nve-icon name="placeholder"></nve-icon> lime-pear</nve-badge>
<nve-badge color="yellow-nova"><nve-icon name="placeholder"></nve-icon> yellow-nova</nve-badge>
<nve-badge color="brand-green"><nve-icon name="placeholder"></nve-icon> brand-green</nve-badge>
</div>
red-cardinal gray-slate gray-denim blue-indigo blue-cobalt blue-sky teal-cyan green-mint teal-seafoam green-grass yellow-amber orange-pumpkin red-tomato pink-magenta purple-plum purple-violet purple-lavender pink-rose green-jade lime-pear yellow-nova brand-green
Flat
Flat container badges with custom colors for a minimal, borderless appearance. Ideal for subtle categorization or when you want to reduce visual noise.
<div nve-layout="row gap:sm align:wrap">
<nve-badge container="flat" color="red-cardinal"><nve-icon name="placeholder"></nve-icon> red-cardinal</nve-badge>
<nve-badge container="flat" color="gray-slate"><nve-icon name="placeholder"></nve-icon> gray-slate</nve-badge>
<nve-badge container="flat" color="gray-denim"><nve-icon name="placeholder"></nve-icon> gray-denim</nve-badge>
<nve-badge container="flat" color="blue-indigo"><nve-icon name="placeholder"></nve-icon> blue-indigo</nve-badge>
<nve-badge container="flat" color="blue-cobalt"><nve-icon name="placeholder"></nve-icon> blue-cobalt</nve-badge>
<nve-badge container="flat" color="blue-sky"><nve-icon name="placeholder"></nve-icon> blue-sky</nve-badge>
<nve-badge container="flat" color="teal-cyan"><nve-icon name="placeholder"></nve-icon> teal-cyan</nve-badge>
<nve-badge container="flat" color="green-mint"><nve-icon name="placeholder"></nve-icon> green-mint</nve-badge>
<nve-badge container="flat" color="teal-seafoam"><nve-icon name="placeholder"></nve-icon> teal-seafoam</nve-badge>
<nve-badge container="flat" color="green-grass"><nve-icon name="placeholder"></nve-icon> green-grass</nve-badge>
<nve-badge container="flat" color="yellow-amber"><nve-icon name="placeholder"></nve-icon> yellow-amber</nve-badge>
<nve-badge container="flat" color="orange-pumpkin"><nve-icon name="placeholder"></nve-icon> orange-pumpkin</nve-badge>
<nve-badge container="flat" color="red-tomato"><nve-icon name="placeholder"></nve-icon> red-tomato</nve-badge>
<nve-badge container="flat" color="pink-magenta"><nve-icon name="placeholder"></nve-icon> pink-magenta</nve-badge>
<nve-badge container="flat" color="purple-plum"><nve-icon name="placeholder"></nve-icon> purple-plum</nve-badge>
<nve-badge container="flat" color="purple-violet"><nve-icon name="placeholder"></nve-icon> purple-violet</nve-badge>
<nve-badge container="flat" color="purple-lavender"
><nve-icon name="placeholder"></nve-icon> purple-lavender</nve-badge
>
<nve-badge container="flat" color="pink-rose"><nve-icon name="placeholder"></nve-icon> pink-rose</nve-badge>
<nve-badge container="flat" color="green-jade"><nve-icon name="placeholder"></nve-icon> green-jade</nve-badge>
<nve-badge container="flat" color="lime-pear"><nve-icon name="placeholder"></nve-icon> lime-pear</nve-badge>
<nve-badge container="flat" color="yellow-nova"><nve-icon name="placeholder"></nve-icon> yellow-nova</nve-badge>
<nve-badge container="flat" color="brand-green"><nve-icon name="placeholder"></nve-icon> brand-green</nve-badge>
</div>
red-cardinal gray-slate gray-denim blue-indigo blue-cobalt blue-sky teal-cyan green-mint teal-seafoam green-grass yellow-amber orange-pumpkin red-tomato pink-magenta purple-plum purple-violet purple-lavender pink-rose green-jade lime-pear yellow-nova brand-green
Emphasis
High emphasis badges with custom colors for important or highlighted content. Use for highlighting critical information.
<div nve-layout="row gap:sm align:wrap">
<nve-badge prominence="emphasis" color="red-cardinal"
><nve-icon name="placeholder"></nve-icon> red-cardinal</nve-badge
>
<nve-badge prominence="emphasis" color="gray-slate"><nve-icon name="placeholder"></nve-icon> gray-slate</nve-badge>
<nve-badge prominence="emphasis" color="gray-denim"><nve-icon name="placeholder"></nve-icon> gray-denim</nve-badge>
<nve-badge prominence="emphasis" color="blue-indigo"><nve-icon name="placeholder"></nve-icon> blue-indigo</nve-badge>
<nve-badge prominence="emphasis" color="blue-cobalt"><nve-icon name="placeholder"></nve-icon> blue-cobalt</nve-badge>
<nve-badge prominence="emphasis" color="blue-sky"><nve-icon name="placeholder"></nve-icon> blue-sky</nve-badge>
<nve-badge prominence="emphasis" color="teal-cyan"><nve-icon name="placeholder"></nve-icon> teal-cyan</nve-badge>
<nve-badge prominence="emphasis" color="green-mint"><nve-icon name="placeholder"></nve-icon> green-mint</nve-badge>
<nve-badge prominence="emphasis" color="teal-seafoam"
><nve-icon name="placeholder"></nve-icon> teal-seafoam</nve-badge
>
<nve-badge prominence="emphasis" color="green-grass"><nve-icon name="placeholder"></nve-icon> green-grass</nve-badge>
<nve-badge prominence="emphasis" color="yellow-amber"
><nve-icon name="placeholder"></nve-icon> yellow-amber</nve-badge
>
<nve-badge prominence="emphasis" color="orange-pumpkin"
><nve-icon name="placeholder"></nve-icon> orange-pumpkin</nve-badge
>
<nve-badge prominence="emphasis" color="red-tomato"><nve-icon name="placeholder"></nve-icon> red-tomato</nve-badge>
<nve-badge prominence="emphasis" color="pink-magenta"
><nve-icon name="placeholder"></nve-icon> pink-magenta</nve-badge
>
<nve-badge prominence="emphasis" color="purple-plum"><nve-icon name="placeholder"></nve-icon> purple-plum</nve-badge>
<nve-badge prominence="emphasis" color="purple-violet"
><nve-icon name="placeholder"></nve-icon> purple-violet</nve-badge
>
<nve-badge prominence="emphasis" color="purple-lavender"
><nve-icon name="placeholder"></nve-icon> purple-lavender</nve-badge
>
<nve-badge prominence="emphasis" color="pink-rose"><nve-icon name="placeholder"></nve-icon> pink-rose</nve-badge>
<nve-badge prominence="emphasis" color="green-jade"><nve-icon name="placeholder"></nve-icon> green-jade</nve-badge>
<nve-badge prominence="emphasis" color="lime-pear"><nve-icon name="placeholder"></nve-icon> lime-pear</nve-badge>
<nve-badge prominence="emphasis" color="yellow-nova"><nve-icon name="placeholder"></nve-icon> yellow-nova</nve-badge>
<nve-badge prominence="emphasis" color="brand-green"><nve-icon name="placeholder"></nve-icon> brand-green</nve-badge>
</div>
red-cardinal gray-slate gray-denim blue-indigo blue-cobalt blue-sky teal-cyan green-mint teal-seafoam green-grass yellow-amber orange-pumpkin red-tomato pink-magenta purple-plum purple-violet purple-lavender pink-rose green-jade lime-pear yellow-nova brand-green
Trend
Trend badges for displaying data changes and metrics. Perfect for dashboards, analytics, or financial data showing positive, negative, or neutral trends.
<div nve-layout="row gap:md">
<nve-badge>0%</nve-badge>
<nve-badge status="success"><nve-icon name="trend-down"></nve-icon> -15%</nve-badge>
<nve-badge status="danger"><nve-icon name="trend-up"></nve-icon> +15%</nve-badge>
</div>
Overflow
Badge with constrained width to show text overflow behavior. Use when you need to control badge width in constrained layouts or responsive designs.
<nve-badge status="pending" style="--width: 150px">some really long content</nve-badge>
some really long content
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