<!--
{
  "availability" : [
    "iOS: 17.0.0 -",
    "iPadOS: 17.0.0 -",
    "macCatalyst: 17.0.0 -",
    "macOS: 14.0.0 -",
    "visionOS: 1.0.0 -"
  ],
  "documentType" : "symbol",
  "framework" : "SwiftUI",
  "identifier" : "/documentation/SwiftUI/BadgeProminence",
  "metadataVersion" : "0.1.0",
  "role" : "Structure",
  "symbol" : {
    "kind" : "Structure",
    "modules" : [
      "SwiftUI"
    ],
    "preciseIdentifier" : "s:7SwiftUI15BadgeProminenceV"
  },
  "title" : "BadgeProminence"
}
-->

# BadgeProminence

The visual prominence of a badge.

```
struct BadgeProminence
```

## Overview

Badges can be used for different kinds of information, from the
passive number of items in a container to the number of required
actions. The prominence of badges in Lists can be adjusted to reflect
this and be made to draw more or less attention to themselves.

Badges will default to `standard` prominence unless specified.

The following example shows a [`List`](/documentation/SwiftUI/List) displaying a list of folders
with an informational badge with lower prominence, showing the number
of items in the folder.

```
List(folders) { folder in
    Text(folder.name)
        .badge(folder.numberOfItems)
}
.badgeProminence(.decreased)
```

## Topics

### Getting background prominence

[`standard`](/documentation/SwiftUI/BadgeProminence/standard)

The standard level of prominence for a badge.

[`increased`](/documentation/SwiftUI/BadgeProminence/increased)

The highest level of prominence for a badge.

[`decreased`](/documentation/SwiftUI/BadgeProminence/decreased)

The lowest level of prominence for a badge.

## Relationships

### Conforms To

[`Hashable`](/documentation/Swift/Hashable)

[`Equatable`](/documentation/Swift/Equatable)

[`SendableMetatype`](/documentation/Swift/SendableMetatype)

[`Sendable`](/documentation/Swift/Sendable)

---

Copyright &copy; 2026 Apple Inc. All rights reserved. | [Terms of Use](https://www.apple.com/legal/internet-services/terms/site.html) | [Privacy Policy](https://www.apple.com/privacy/privacy-policy)