---
title: Badge
description: Inline-Labels für Status, Kategorien und Metadaten – 11 Farbvarianten, 4 Größen, Symbole, Pill-/abgerundete Formen und Konturen.
---

> **For AI agents:** the complete documentation index is at [llms.txt](/docs/llms.txt). Append `.md` to any page URL for its markdown version.

Verwende die `<Badge>`-Komponente, um Inhalte mit Statusindikatoren, Kategoriebezeichnungen oder Versionsmarkierungen zu versehen. Badges werden als kompakte Inline-Elemente dargestellt und können daher in Fließtext eingefügt oder in einem Layout angeordnet werden.

## Einfaches Badge

Ein einfaches Badge mit Standarddarstellung:

<Badge>Standard</Badge>

```mdx
<Badge>Default</Badge>
```

## Farben

Badges sind in 11 Farbvarianten verfügbar, um unterschiedliche Bedeutungen zu vermitteln:

<div className="flex flex-wrap gap-2 my-4">
  <Badge color="gray">Grau</Badge>
  <Badge color="blue">Blau</Badge>
  <Badge color="green">Grün</Badge>
  <Badge color="yellow">Gelb</Badge>
  <Badge color="orange">Orange</Badge>
  <Badge color="red">Rot</Badge>
  <Badge color="purple">Violett</Badge>
</div>

```mdx
<Badge color="gray">Gray</Badge>
<Badge color="blue">Blue</Badge>
<Badge color="green">Green</Badge>
<Badge color="yellow">Yellow</Badge>
<Badge color="orange">Orange</Badge>
<Badge color="red">Red</Badge>
<Badge color="purple">Purple</Badge>
```

### Oberflächenfarben

Für Badges, die sich an den Seitenhintergrund anpassen:

<div className="flex flex-wrap gap-2 my-4">
  <Badge color="white">Weiß</Badge>
  <Badge color="surface">Oberfläche</Badge>
</div>

```mdx
<Badge color="white">White</Badge>
<Badge color="surface">Surface</Badge>
```

### Destruktive Farben

Für Warn- oder Fehlerzustände:

<div className="flex flex-wrap gap-2 my-4">
  <Badge color="white-destructive">Weiß, destruktiv</Badge>
  <Badge color="surface-destructive">Oberfläche, destruktiv</Badge>
</div>

```mdx
<Badge color="white-destructive">White Destructive</Badge>
<Badge color="surface-destructive">Surface Destructive</Badge>
```

## Mit Symbolen

Füge Symbole hinzu, um Badges aussagekräftiger zu machen:

<div className="flex flex-wrap gap-2 my-4">
  <Badge icon="circle-check" color="green">Verifiziert</Badge>
  <Badge icon="star" color="yellow">Hervorgehoben</Badge>
  <Badge icon="bolt" color="purple">Neu</Badge>
  <Badge icon="clock" color="blue">Ausstehend</Badge>
</div>

```mdx
<Badge icon="circle-check" color="green">Verified</Badge>
<Badge icon="star" color="yellow">Featured</Badge>
<Badge icon="bolt" color="purple">New</Badge>
<Badge icon="clock" color="blue">Pending</Badge>
```

### Symboltypen

Gib mit `iconType` einen anderen Symbolstil an:

<div className="flex flex-wrap gap-2 my-4">
  <Badge icon="star" iconType="solid" color="yellow">Vollflächig</Badge>
  <Badge icon="star" iconType="regular" color="yellow">Standard</Badge>
  <Badge icon="star" iconType="duotone" color="yellow">Duotone</Badge>
  <Badge icon="github" iconType="brands" color="gray">GitHub</Badge>
</div>

```mdx
<Badge icon="star" iconType="solid" color="yellow">Solid</Badge>
<Badge icon="star" iconType="regular" color="yellow">Regular</Badge>
<Badge icon="star" iconType="duotone" color="yellow">Duotone</Badge>
<Badge icon="github" iconType="brands" color="gray">GitHub</Badge>
```

## Größen

Für unterschiedliche Kontexte stehen vier Größen zur Verfügung:

<div className="flex flex-wrap items-center gap-2 my-4">
  <Badge size="xs" color="blue">Extra klein</Badge>
  <Badge size="sm" color="blue">Klein</Badge>
  <Badge size="md" color="blue">Mittel</Badge>
  <Badge size="lg" color="blue">Groß</Badge>
</div>

```mdx
<Badge size="xs" color="blue">Extra Small</Badge>
<Badge size="sm" color="blue">Small</Badge>
<Badge size="md" color="blue">Medium</Badge>
<Badge size="lg" color="blue">Large</Badge>
```

## Formen

Wähle zwischen abgerundeten Ecken und einer Pillenform:

<div className="flex flex-wrap gap-2 my-4">
  <Badge shape="rounded" color="purple">Abgerundet</Badge>
  <Badge shape="pill" color="purple">Pille</Badge>
</div>

```mdx
<Badge shape="rounded" color="purple">Rounded</Badge>
<Badge shape="pill" color="purple">Pill</Badge>
```

## Konturvariante

Verwende Badges mit Kontur für eine dezentere Darstellung:

<div className="flex flex-wrap gap-2 my-4">
  <Badge stroke color="blue">Blau mit Kontur</Badge>
  <Badge stroke color="green">Grün mit Kontur</Badge>
  <Badge stroke color="red">Rot mit Kontur</Badge>
  <Badge stroke color="purple">Violett mit Kontur</Badge>
</div>

```mdx
<Badge stroke color="blue">Outlined Blue</Badge>
<Badge stroke color="green">Outlined Green</Badge>
<Badge stroke color="red">Outlined Red</Badge>
<Badge stroke color="purple">Outlined Purple</Badge>
```

## Deaktivierter Zustand

Reduziere die Deckkraft inaktiver Badges:

<div className="flex flex-wrap gap-2 my-4">
  <Badge disabled color="gray">Inaktiv</Badge>
  <Badge disabled color="blue">Deaktiviert</Badge>
</div>

```mdx
<Badge disabled color="gray">Inactive</Badge>
<Badge disabled color="blue">Disabled</Badge>
```

## Inline-Verwendung

Badges funktionieren innerhalb von Text. Für diese Funktion ist ein <Badge color="orange" size="sm">Premium</Badge>-Abonnement erforderlich. Du kannst Elemente auch als <Badge color="green" size="sm">Neu</Badge> oder <Badge color="red" size="sm">Veraltet</Badge> kennzeichnen.

```mdx
This feature requires a <Badge color="orange" size="sm">Premium</Badge> subscription.
You can also mark items as <Badge color="green" size="sm">New</Badge> or
<Badge color="red" size="sm">Deprecated</Badge>.
```

## Props

<ParamField name="color" type="string" default="gray">
  Farbvariante: `gray`, `blue`, `green`, `yellow`, `orange`, `red`, `purple`, `white`, `surface`, `white-destructive`, `surface-destructive`.
</ParamField>

<ParamField name="size" type="string" default="md">
  Badge-Größe: `xs`, `sm`, `md`, `lg`.
</ParamField>

<ParamField name="shape" type="string" default="rounded">
  Badge-Form: `rounded`, `pill`.
</ParamField>

<ParamField name="icon" type="string">
  Name des Font Awesome-Symbols.
</ParamField>

<ParamField name="iconType" type="string">
  Symbolstil: `regular`, `solid`, `light`, `thin`, `sharp-solid`, `duotone`, `brands`.
</ParamField>

<ParamField name="stroke" type="boolean" default="false">
  Als Badge mit Kontur und transparentem Hintergrund anzeigen.
</ParamField>

<ParamField name="disabled" type="boolean" default="false">
  Deckkraft reduzieren, um einen inaktiven Zustand anzuzeigen.
</ParamField>

<ParamField name="className" type="string">
  Zusätzliche CSS-Klassen für die individuelle Gestaltung.
</ParamField>

## Wie geht es weiter?

<Columns cols={2}>
  <Card title="Übersicht der Komponenten" icon="puzzle-piece" href="/de/components/overview">
    Alle verfügbaren Komponenten durchsuchen
  </Card>
  <Card title="MDX-Grundlagen" icon="file-code" href="/de/content/mdx-basics">
    Erfahren, wie Komponenten in MDX verwendet werden
  </Card>
</Columns>