macOS Tertiary Label

NSColor.tertiaryLabelColor

Typographic & Label Hierarchy

Adaptive System Token•macOS 10.10+ / 10.14+, AppKit

Complete technical specification and developer reference for Tertiary Label in Apple's macOS design system. In light appearance, it resolves to HEX rgba(0, 0, 0, 0.26); in dark appearance, it dynamically adapts to HEX rgba(255, 255, 255, 0.25). Features wide-gamut Display P3 values, UIKit bridge (UIColor.tertiaryLabel), AppKit bridge (NSColor.tertiaryLabelColor), WCAG contrast audit, and Xcode drop-in initializers.

Light Modergba(0, 0, 0, 0.26)

Dark Modergba(255, 255, 255, 0.25)

Tertiary Label Color Preview

The text of a label of lesser importance than a secondary label.

ColorNSColor.tertiaryLabelColor

Copy:

Dynamic Asset

Typographic & Label Hierarchy

macOS 10.10+ / 10.14+, AppKit

Initializers & Color Spaces

Color(r:g:b:)Color(red: 0.000, green: 0.000, blue: 0.000)

Color(r:g:b:op:)Color(red: 0.000, green: 0.000, blue: 0.000, opacity: 0.26)

Color(hue:sat:bri:)HSBColor(hue: 0.000, saturation: 0.000, brightness: 0.000, opacity: 0.26)

Color(.displayP3)Wide GamutColor(.displayP3, red: 0.000, green: 0.000, blue: 0.000, opacity: 0.26)

Color(.sRGB)Color(.sRGB, red: 0.000, green: 0.000, blue: 0.000, opacity: 0.26)

Color(hex:)ExtensionColor(hex: "rgba(0, 0, 0, 0.26)")

#colorLiteralXcode#colorLiteral(red: 0.000, green: 0.000, blue: 0.000, alpha: 0.26)

Color(uiColor:)iOSColor(uiColor: UIColor(red: 0.000, green: 0.000, blue: 0.000, alpha: 0.26))

Active HEX: rgba(0, 0, 0, 0.26)P3 R: 0.000 G: 0.000 B: 0.000

Technical Color Specifications

Exact resolved HEX codes, sRGB 8-bit components, HSL, and normalized Swift floating-point decimals for Light and Dark modes.

Color Metric / Space	Light Appearance	Dark Appearance	Swift Code Literal
HEX Code	rgba(0, 0, 0, 0.26)	rgba(255, 255, 255, 0.25)	Color(hex: "rgba(0, 0, 0, 0.26)")
sRGB (0–255)	rgba(0, 0, 0, 0.26)	rgba(255, 255, 255, 0.25)	(r: 0.000, g: 0.000, b: 0.000)
Display P3 (Wide Gamut)	P3 (0.000, 0.000, 0.000)	P3 (1.000, 1.000, 1.000)	Color(.displayP3, ...)
HSL / HSB	hsla(0, 0%, 0%, 0.26)	hsla(0, 0%, 100%, 0.25)	Color(hue:sat:bri:)
Platform Bridge	UIKit: `UIColor.tertiaryLabel`	AppKit: `NSColor.tertiaryLabelColor`	Color(uiColor:) / Color(nsColor:)

Light Appearance

Light Theme

HEX Code

rgba(0, 0, 0, 0.26)

RGB (0–255)

rgba(0, 0, 0, 0.26)

HSL

hsla(0, 0%, 0%, 0.26)

Normalized Swift Literal:

(r: 0.000, g: 0.000, b: 0.000)

Dark Appearance

Dark Theme

HEX Code

rgba(255, 255, 255, 0.25)

RGB (0–255)

rgba(255, 255, 255, 0.25)

HSL

hsla(0, 0%, 100%, 0.25)

Normalized Swift Literal:

(r: 1.000, g: 1.000, b: 1.000)

Drop-In Developer Snippets

Ready-to-paste code blocks for Xcode asset catalogs and Swift files.

Xcode Location: Save as Contents.json inside Assets.xcassets/Tertiary Label.colorset/

Includes Light + Dark Modes

Contents.json

{
  "colors": [
    {
      "color": {
        "color-space": "srgb",
        "components": {
          "red": "0.000",
          "green": "0.000",
          "blue": "0.000",
          "alpha": "0.260"
        }
      },
      "idiom": "universal"
    },
    {
      "appearances": [
        {
          "appearance": "luminosity",
          "value": "dark"
        }
      ],
      "color": {
        "color-space": "srgb",
        "components": {
          "red": "1.000",
          "green": "1.000",
          "blue": "1.000",
          "alpha": "0.250"
        }
      },
      "idiom": "universal"
    }
  ],
  "info": {
    "author": "xcode",
    "version": 1
  }
}

Live UI Component Sandbox

Preview Color.tertiary label inside standard Apple interface components.

Interactive Controls

Active TagBadge 99+

Toggle Tint

Container & Typography Styling

●SwiftUI Notification

Just now

Demonstrates how Apple designers pair system background tints with dynamic Tertiary Label accents.

Dynamic Headline in Tertiary Label

.foregroundStyle(NSColor.tertiaryLabelColor)

Platform Implementation Snippets

Ready-to-use Swift code for SwiftUI, UIKit, and AppKit applications.

AppKit (macOS Swift)

// AppKit (macOS)
let button = NSButton()
button.contentTintColor = NSColor.tertiaryLabelColor

// Custom Layer Tint
let layer = CALayer()
layer.backgroundColor = NSColor.tertiaryLabelColor.cgColor

// Bridging AppKit into SwiftUI
let swiftUIColor = Color(nsColor: .tertiaryLabelColor)

WCAG 2.1 Accessibility Contrast Audit

Contrast calculations of Tertiary Label against pure white and iOS OLED dark surfaces.

Light Mode (rgba(0, 0, 0, 0.26))on White (#FFF)

Contrast Ratio:1.88:1

Normal Text (4.5:1 AA): Fail

Dark Mode (rgba(255, 255, 255, 0.25))on Dark (#1C1C1E)

Contrast Ratio:2.28:1

Normal Text (4.5:1 AA): Fail

Recommended HIG Use Cases

Table view and outline view cells
Window title bar text and dialog headings
Form field captions and status labels

Anti-Patterns to Avoid

Full window background surfaces
Thick border fills

Browse More macOS Colors

Quickly jump to other Apple system colors and semantic tokens.

Frequently Asked Questions

How do I use NSColor.tertiaryLabelColor in macOS AppKit apps?

In AppKit, assign NSColor.tertiaryLabelColor to NSView, NSTextField, or NSButton styling. In SwiftUI on macOS, bridge it using Color(nsColor: .tertiaryLabelColor).

What is the HEX code for macOS Tertiary Label in light and dark mode?

In light appearance, Tertiary Label resolves to rgba(0, 0, 0, 0.26). In dark appearance, it automatically adapts to rgba(255, 255, 255, 0.25).

How do I bridge NSColor.tertiaryLabelColor into SwiftUI?

In SwiftUI views on macOS, instantiate Color(nsColor: .tertiaryLabelColor) to access the native AppKit dynamic color token.

Does Tertiary Label adapt to Dark Mode and vibrancy in macOS?

Yes, NSColor.tertiaryLabelColor is an appearance-aware NSColor that updates automatically when switching between light and dark modes or across vibrant desktop materials.

Why use AppKit system colors instead of hardcoded hex values?

NSColor system tokens adapt automatically to user accent color preferences, Dark Mode, and accessibility contrast settings.