iOS Secondary System Grouped Background

UIColor.secondarySystemGroupedBackground

Layout Canvas & Container Surfaces

Adaptive System Token•iOS 13.0+, iPadOS 13.0+, macCatalyst 13.0+

Complete technical specification and developer reference for Secondary System Grouped Background in Apple's iOS & iPadOS design system. In light appearance, it resolves to HEX #FFFFFF; in dark appearance, it dynamically adapts to HEX #1C1C1E. Features wide-gamut Display P3 values, UIKit bridge (UIColor.secondarySystemGroupedBackground), AppKit bridge (NSColor.secondarySystemGroupedBackground), WCAG contrast audit, and Xcode drop-in initializers.

Light Mode#FFFFFF

Dark Mode#1C1C1E

Secondary System Grouped Background Color Preview

A grouped background color for secondary surfaces.

ColorUIColor.secondarySystemGroupedBackground

Copy:

Dynamic Asset

Layout Canvas & Container Surfaces

iOS 13.0+, iPadOS 13.0+, macCatalyst 13.0+

Initializers & Color Spaces

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

Color(r:g:b:op:)Color(red: 1.000, green: 1.000, blue: 1.000, opacity: 1.00)

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

Color(.displayP3)Wide GamutColor(.displayP3, red: 1.000, green: 1.000, blue: 1.000, opacity: 1.00)

Color(.sRGB)Color(.sRGB, red: 1.000, green: 1.000, blue: 1.000, opacity: 1.00)

Color(hex:)ExtensionColor(hex: "#FFFFFF")

#colorLiteralXcode#colorLiteral(red: 1.000, green: 1.000, blue: 1.000, alpha: 1.00)

Color(uiColor:)iOSColor(uiColor: UIColor(red: 1.000, green: 1.000, blue: 1.000, alpha: 1.00))

Active HEX: #FFFFFFP3 R: 1.000 G: 1.000 B: 1.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	#FFFFFF	#1C1C1E	Color(hex: "#FFFFFF")
sRGB (0–255)	rgb(255, 255, 255)	rgb(28, 28, 30)	(r: 1.000, g: 1.000, b: 1.000)
Display P3 (Wide Gamut)	P3 (1.000, 1.000, 1.000)	P3 (0.110, 0.110, 0.118)	Color(.displayP3, ...)
HSL / HSB	hsl(0, 0%, 100%)	hsl(240, 3%, 11%)	Color(hue:sat:bri:)
Platform Bridge	UIKit: `UIColor.secondarySystemGroupedBackground`	AppKit: `NSColor.secondarySystemGroupedBackground`	Color(uiColor:) / Color(nsColor:)

Light Appearance

Light Theme

HEX Code

#FFFFFF

RGB (0–255)

rgb(255, 255, 255)

HSL

hsl(0, 0%, 100%)

Normalized Swift Literal:

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

Dark Appearance

Dark Theme

HEX Code

#1C1C1E

RGB (0–255)

rgb(28, 28, 30)

HSL

hsl(240, 3%, 11%)

Normalized Swift Literal:

(r: 0.110, g: 0.110, b: 0.118)

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/Secondary System Grouped Background.colorset/

Includes Light + Dark Modes

Contents.json

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

Live UI Component Sandbox

Preview Color.secondary system grouped background 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 Secondary System Grouped Background accents.

Dynamic Headline in Secondary System Grouped Background

.foregroundStyle(UIColor.secondarySystemGroupedBackground)

Platform Implementation Snippets

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

UIKit (Swift)

// UIKit (iOS, tvOS, watchOS)
let view = UIView()
view.backgroundColor = UIColor.secondarySystemGroupedBackground

// Label Tinting
let label = UILabel()
label.textColor = UIColor.secondarySystemGroupedBackground

// Bridging UIKit into SwiftUI
let swiftUIColor = Color(uiColor: .secondarySystemGroupedBackground)

WCAG 2.1 Accessibility Contrast Audit

Contrast calculations of Secondary System Grouped Background against pure white and iOS OLED dark surfaces.

Light Mode (#FFFFFF)on White (#FFF)

Contrast Ratio:1.00:1

Normal Text (4.5:1 AA): Fail

Dark Mode (#1C1C1E)on Dark (#1C1C1E)

Contrast Ratio:1.00:1

Normal Text (4.5:1 AA): Fail

Recommended HIG Use Cases

Root window backgrounds and view controllers
Card sheets, modal presentations, and grouped tables
Container layout backdrops

Anti-Patterns to Avoid

Direct typographic rendering
Fine line separators and icons

Browse More iOS & iPadOS Colors

Quickly jump to other Apple system colors and semantic tokens.

Secondary System Background

Tertiary System Background

Frequently Asked Questions

How do I use UIColor.secondarySystemGroupedBackground in iOS and iPadOS apps?

In UIKit, assign UIColor.secondarySystemGroupedBackground directly to properties like view.backgroundColor, label.textColor, or tintColor. In SwiftUI, bridge it using Color(uiColor: .secondarySystemGroupedBackground).

What is the HEX code for iOS Secondary System Grouped Background in light and dark mode?

In light appearance, Secondary System Grouped Background resolves to #FFFFFF. In dark appearance, it automatically adapts to #1C1C1E.

How do I bridge UIColor.secondarySystemGroupedBackground into SwiftUI?

In SwiftUI views on iOS 15+, initialize Color(uiColor: .secondarySystemGroupedBackground) to utilize this system color with full appearance dynamism.

Does Secondary System Grouped Background adapt automatically to dark appearance in iOS?

Yes, UIColor.secondarySystemGroupedBackground is an appearance-aware dynamic UIColor that automatically responds to UITraitCollection changes between light and dark appearances.

Why use UIKit system colors instead of hardcoded hex values?

System colors dynamically adapt to Dark Mode, Accessibility Increase Contrast mode, and future iOS visual refinements without manual color bookkeeping.