--- title: "Color Variants | Explore SwiftUI" description: "HierarchicalShapeStyle, a shape style that maps to one of the numbered content styles. Learn how to use Color Variants in SwiftUI with visual code examples." canonical_url: "https://exploreswiftui.com/library/color/color-variants" meta: author: "Explore SwiftUI" "og:description": "HierarchicalShapeStyle, a shape style that maps to one of the numbered content styles. Learn how to use Color Variants in SwiftUI with visual code examples." "og:image": "https://exploreswiftui.com/_og/d/c_Component%2Ctitle_Color%2BVariants%2Cdescription_~SGllcmFyY2hpY2FsU2hhcGVTdHlsZSwgYSBzaGFwZSBzdHlsZSB0aGF0IG1hcHMgdG8gb25lIG9mIHRoZSBudW1iZXJlZCBjb250ZW50IHN0eWxlcw%2Ccategory_Color%2Cimage_~L2FwaS9pbWFnZXMvOS92YXJpYW50cy8yMDk~dj0xNzkwMDczNDc4ODQyJnI9MiZ3PTEyODAmcT04NSZmPWpwZWc%2CimageMode_crop%2CimagePosition_center%2CimageFrame_~cG9zaXRpb246IGFic29sdXRlOyByaWdodDogMDsgd2lkdGg6IDY0MHB4OyBoZWlnaHQ6IDQ4MHB4OyBkaXNwbGF5OiBmbGV4OyBvdmVyZmxvdzogaGlkZGVuOyBiYWNrZ3JvdW5kOiAjRkZGRkZGOyBib3gtc2hhZG93OiAwIC0xMHB4IDUwcHggcmdiYSgzNyw5OSwyMzUsMC4xOCk7IGJvcmRlci1sZWZ0OiAxcHggc29saWQgcmdiYSgwLDAsMCwwLjA2KTsgdG9wOiA3NXB4OyBib3JkZXItdG9wOiAxcHggc29saWQgcmdiYSgwLDAsMCwwLjA2KTsgYm9yZGVyLWJvdHRvbTogMXB4IHNvbGlkIHJnYmEoMCwwLDAsMC4wNik7IGJvcmRlci10b3AtbGVmdC1yYWRpdXM6IDMycHg7IGJvcmRlci1ib3R0b20tbGVmdC1yYWRpdXM6IDMycHg7%2Cprops_eyJwbGF0Zm9ybXMiOlsiaU9TIiwiaVBhZE9TIiwibWFjT1MiLCJ3YXRjaE9TIiwidHZPUyIsInZpc2lvbk9TIl19%2Cp_Ii9saWJyYXJ5L2NvbG9yL2NvbG9yLXZhcmlhbnRzIg%2Cs_tZTdQDcJzgk3NRdK.png" "og:image:height": "630" "og:image:type": image/png "og:image:width": "1200" "og:title": "Color Variants | Explore SwiftUI" "twitter:description": "HierarchicalShapeStyle, a shape style that maps to one of the numbered content styles. Learn how to use Color Variants in SwiftUI with visual code examples." "twitter:image": "https://exploreswiftui.com/_og/d/c_Component%2Ctitle_Color%2BVariants%2Cdescription_~SGllcmFyY2hpY2FsU2hhcGVTdHlsZSwgYSBzaGFwZSBzdHlsZSB0aGF0IG1hcHMgdG8gb25lIG9mIHRoZSBudW1iZXJlZCBjb250ZW50IHN0eWxlcw%2Ccategory_Color%2Cimage_~L2FwaS9pbWFnZXMvOS92YXJpYW50cy8yMDk~dj0xNzkwMDczNDc4ODQyJnI9MiZ3PTEyODAmcT04NSZmPWpwZWc%2CimageMode_crop%2CimagePosition_center%2CimageFrame_~cG9zaXRpb246IGFic29sdXRlOyByaWdodDogMDsgd2lkdGg6IDY0MHB4OyBoZWlnaHQ6IDQ4MHB4OyBkaXNwbGF5OiBmbGV4OyBvdmVyZmxvdzogaGlkZGVuOyBiYWNrZ3JvdW5kOiAjRkZGRkZGOyBib3gtc2hhZG93OiAwIC0xMHB4IDUwcHggcmdiYSgzNyw5OSwyMzUsMC4xOCk7IGJvcmRlci1sZWZ0OiAxcHggc29saWQgcmdiYSgwLDAsMCwwLjA2KTsgdG9wOiA3NXB4OyBib3JkZXItdG9wOiAxcHggc29saWQgcmdiYSgwLDAsMCwwLjA2KTsgYm9yZGVyLWJvdHRvbTogMXB4IHNvbGlkIHJnYmEoMCwwLDAsMC4wNik7IGJvcmRlci10b3AtbGVmdC1yYWRpdXM6IDMycHg7IGJvcmRlci1ib3R0b20tbGVmdC1yYWRpdXM6IDMycHg7%2Cprops_eyJwbGF0Zm9ybXMiOlsiaU9TIiwiaVBhZE9TIiwibWFjT1MiLCJ3YXRjaE9TIiwidHZPUyIsInZpc2lvbk9TIl19%2Cp_Ii9saWJyYXJ5L2NvbG9yL2NvbG9yLXZhcmlhbnRzIg%2Cs_tZTdQDcJzgk3NRdK.png" "twitter:title": "Color Variants | Explore SwiftUI" --- > Index of every page on this site: [llms.txt](https://exploreswiftui.com/llms.txt) **Interactive previews**[ iPhone](https://exploreswiftui.com/iphone?element=9) # **Color Variants** HierarchicalShapeStyle, a shape style that maps to one of the numbered content styles ![Color Variants - iOS on iPhone - Portrait - Flat Design - Light Mode - Preview](https://exploreswiftui.com/api/images/9/variants/209?v=1790073478842&r=2&w=800&q=80&f=webp) ### **Platform Compatibility** iOS 15.0+ iPadOS 15.0+ macOS 12.0+ watchOS 8.0+ tvOS 15.0+ visionOS 1.0+ ### **Tags** ### **SwiftUI Code** [ Docs](https://developer.apple.com/documentation/swiftui/hierarchicalshapestyle) ``` VStack { HStack { smallRect .foregroundStyle(.blue) smallRect .foregroundStyle(.blue.secondary) smallRect .foregroundStyle(.blue.tertiary) smallRect .foregroundStyle(.blue.quaternary) smallRect .foregroundStyle(.blue.quinary) } HStack { smallRect .foregroundStyle(.red) smallRect .foregroundStyle(.red.secondary) smallRect .foregroundStyle(.red.tertiary) smallRect .foregroundStyle(.red.quaternary) smallRect .foregroundStyle(.red.quinary) } HStack { smallRect .foregroundStyle(.orange) smallRect .foregroundStyle(.orange.secondary) smallRect .foregroundStyle(.orange.tertiary) smallRect .foregroundStyle(.orange.quaternary) smallRect .foregroundStyle(.orange.quinary) } // ... } ``` ### **Found an issue or have a suggestion?** Created: May 29, 2025Updated: May 31, 2025 ![Connect Wizard](https://exploreswiftui.com/_ipx/f_webp&q_80&s_48x48/images/connect-wizard-icon.png) **Connect Wizard** **Unlock insights App Store Connect doesn’t show you.** [** Get Started **](https://apps.apple.com/app/apple-store/id6747314580?pt=121213751&ct=Explore%20SwiftUI%20Banner&mt=8) ### **More Color Components ** [**View all **](https://exploreswiftui.com/library/color) ![Color Opacity - iOS on iPhone - Portrait - Flat Design - Light Mode - Preview](https://exploreswiftui.com/api/images/16/variants/124?v=1790073478842&r=2&w=412&q=75&f=webp) ### **Color Opacity** The Color opacity modifier ![Color Gradient - iOS on iPhone - Portrait - Flat Design - Light Mode - Preview](https://exploreswiftui.com/api/images/15/variants/143?v=1790073478842&r=2&w=412&q=75&f=webp) ### **Color Gradient** The Color gradient modifier ![UIKit Separator Colors - iOS on iPhone - Portrait - Flat Design - Light Mode - Preview](https://exploreswiftui.com/api/images/14/variants/57?v=1790073478842&r=2&w=412&q=75&f=webp) ### **UIKit Separator Colors** The UIKit separator colors that are also used in other components, such as the TextField ![UIKit Content Background colors - iOS on iPhone - Portrait - Flat Design - Light Mode - Preview](https://exploreswiftui.com/api/images/13/variants/53?v=1790073478842&r=2&w=412&q=75&f=webp) ### **UIKit Content Background colors** The UIKit colors that are also used in other components like in List and GroupBox ![UIKit Text Colors - iOS on iPhone - Portrait - Flat Design - Light Mode - Preview](https://exploreswiftui.com/api/images/12/variants/55?v=1790073478842&r=2&w=412&q=75&f=webp) ### **UIKit Text Colors** The UIKit text colors that are also used in other components, such as the TextField ![UIKit Fill Colors - iOS on iPhone - Portrait - Flat Design - Light Mode - Preview](https://exploreswiftui.com/api/images/11/variants/43?v=1790073478842&r=2&w=412&q=75&f=webp) ### **UIKit Fill Colors** ![UIKit Label Colors - iOS on iPhone - Portrait - Flat Design - Light Mode - Preview](https://exploreswiftui.com/api/images/10/variants/45?v=1790073478842&r=2&w=412&q=75&f=webp) ### **UIKit Label Colors** ![Semantic Colors - iOS on iPhone - Portrait - Flat Design - Light Mode - Preview](https://exploreswiftui.com/api/images/8/variants/51?v=1790073478842&r=2&w=412&q=75&f=webp) ### **Semantic Colors** ### **Explore Other Components ** [**Browse all **](https://exploreswiftui.com/) ![SegmentedPickerStyle - iOS on iPhone - Portrait - Liquid Glass - Light Mode - Preview](https://exploreswiftui.com/api/images/185/variants/583?v=1790073478842&r=2&w=412&q=75&f=webp) ### **SegmentedPickerStyle** A picker style that presents the options in a segmented control. Use this style when there are two to five options. Consider using menu when there are more than five options. ![Message Item Alert - iOS on iPhone - Portrait - Liquid Glass - Light Mode - Preview](https://exploreswiftui.com/api/images/198/variants/381?v=1790073478842&r=2&w=412&q=75&f=webp) ### **Message Item Alert** Presents an alert with a message using the given data to produce the alert’s content and a localized string key for a title. ![LinearCapacityGaugeStyle - iOS on iPhone - Portrait - Liquid Glass - Light Mode - Preview](https://exploreswiftui.com/api/images/43/variants/267?v=1790073478842&r=2&w=412&q=75&f=webp) ### **LinearCapacityGaugeStyle** A gauge style that displays a bar that fills from leading to trailing edges as the gauge’s current value increases ![Prefer Vertical Toolbar Items - iOS on iPhone Duo - Landscape - Closed - Liquid Glass - Light Mode - Preview](https://exploreswiftui.com/api/images/248/variants/1749?v=1790419867105&r=2&w=412&q=75&f=webp) ### **Prefer Vertical Toolbar Items** A compression behavior that prioritizes keeping toolbar items visible over other elements, such as tabs. By default, tabs are prioritized. ![Glass Effect Container - iOS on iPhone - Portrait - Liquid Glass - Light Mode - Preview](https://exploreswiftui.com/api/images/96/variants/377?v=1790073478842&r=2&w=412&q=75&f=webp) ### **Glass Effect Container** A view that combines multiple Liquid Glass shapes into a single shape that can morph individual shapes into one another ![Upgrade Only Subscription Store View - iOS on iPhone - Portrait - Liquid Glass - Light Mode - Preview](https://exploreswiftui.com/api/images/228/variants/579?v=1790073478842&r=2&w=412&q=75&f=webp) ### **Upgrade Only Subscription Store View** Creates a view that loads all subscriptions from a subscription group but displays only the higher-level ones. In this case, the VIP Kitty Pass is already active, which is why only the higher-tier Royal Kitty Pass is displayed. ![RenameButton - iOS on iPhone - Portrait - Liquid Glass - Light Mode - Preview](https://exploreswiftui.com/api/images/37/variants/213?v=1790073478842&r=2&w=412&q=75&f=webp) ### **RenameButton** A button that triggers a standard rename action ![Capsule Text Field - macOS - Liquid Glass - Light Mode - Preview](https://exploreswiftui.com/api/images/240/variants/186?v=1790073478842&r=2&w=412&q=75&f=webp) ### **Capsule Text Field** Gives your text field a capsule shape. This only has a visible effect on macOS, where the capsule shape is not the default. ```json {"@context":"https://schema.org","@graph":[{"@id":"https://exploreswiftui.com/#website","@type":"WebSite","description":"A visual library for SwiftUI APIs, components, and modifiers","inLanguage":"en-US","name":"Explore SwiftUI","url":"https://exploreswiftui.com/","publisher":{"@id":"https://exploreswiftui.com/#identity"}},{"@id":"https://exploreswiftui.com/library/color/color-variants#webpage","@type":"WebPage","dateModified":"2025-05-31T17:54:05.824Z","datePublished":"2025-05-29T08:54:27.867Z","description":"HierarchicalShapeStyle, a shape style that maps to one of the numbered content styles. Learn how to use Color Variants in SwiftUI with visual code examples.","name":"Color Variants","url":"https://exploreswiftui.com/library/color/color-variants","breadcrumb":{"@id":"https://exploreswiftui.com/library/color/color-variants#breadcrumb"},"isPartOf":{"@id":"https://exploreswiftui.com/#website"},"potentialAction":[{"@type":"ReadAction","target":["https://exploreswiftui.com/library/color/color-variants"]}],"primaryImageOfPage":{"@id":"https://exploreswiftui.com/#logo"}},{"@id":"https://exploreswiftui.com/#identity","@type":"Organization","description":"A visual library for SwiftUI APIs, components, and modifiers","name":"Explore SwiftUI","url":"https://exploreswiftui.com","logo":{"@id":"https://exploreswiftui.com/#logo"},"sameAs":["https://x.com/Typ0genius","https://mastodon.social/@Typ0genius"]},{"@id":"https://exploreswiftui.com/library/color/color-variants#article","dateModified":"2025-05-31T17:54:05.824Z","datePublished":"2025-05-29T08:54:27.867Z","description":"HierarchicalShapeStyle, a shape style that maps to one of the numbered content styles. Learn how to use Color Variants in SwiftUI with visual code examples.","headline":"Color Variants","inLanguage":"en-US","name":"Color Variants","thumbnailUrl":"https://exploreswiftui.com/api/images/9/variants/209?v=1790073478842&r=2","url":"https://exploreswiftui.com/library/color/color-variants","@type":["Article","TechArticle"],"about":{"@type":"Thing","name":"SwiftUI"},"author":{"@id":"https://exploreswiftui.com/#identity"},"image":{"@id":"https://exploreswiftui.com/#/schema/image/1"},"isPartOf":{"@type":"WebSite","name":"Explore SwiftUI","url":"https://exploreswiftui.com"},"mainEntityOfPage":{"@id":"https://exploreswiftui.com/library/color/color-variants#webpage"},"publisher":{"@id":"https://exploreswiftui.com/#identity"}},{"@id":"https://exploreswiftui.com/library/color/color-variants#/schema/software-source-code/1","@type":"SoftwareSourceCode","codeRepository":"https://developer.apple.com/documentation/swiftui/hierarchicalshapestyle","codeSampleType":"full example","description":"HierarchicalShapeStyle, a shape style that maps to one of the numbered content styles. Learn how to use Color Variants in SwiftUI with visual code examples.","name":"Color Variants SwiftUI Example","programmingLanguage":"Swift","runtimePlatform":"SwiftUI","text":"VStack {\n HStack {\n smallRect\n .foregroundStyle(.blue)\n smallRect\n .foregroundStyle(.blue.secondary)\n smallRect\n .foregroundStyle(.blue.tertiary)\n smallRect\n .foregroundStyle(.blue.quaternary)\n smallRect\n .foregroundStyle(.blue.quinary)\n }\n HStack {\n smallRect\n .foregroundStyle(.red)\n smallRect\n .foregroundStyle(.red.secondary)\n smallRect\n .foregroundStyle(.red.tertiary)\n smallRect\n .foregroundStyle(.red.quaternary)\n smallRect\n .foregroundStyle(.red.quinary)\n }\n HStack {\n smallRect\n .foregroundStyle(.orange)\n smallRect\n .foregroundStyle(.orange.secondary)\n smallRect\n .foregroundStyle(.orange.tertiary)\n smallRect\n .foregroundStyle(.orange.quaternary)\n smallRect\n .foregroundStyle(.orange.quinary)\n }\n // ...\n}","about":[{"@type":"Thing","name":"SwiftUI"},{"@type":"Thing","name":"Color"},{"@type":"Thing","name":"Color Variants"}]},{"@id":"https://exploreswiftui.com/library/color/color-variants#breadcrumb","@type":"BreadcrumbList","itemListElement":[{"@type":"ListItem","name":"Home","item":"https://exploreswiftui.com","position":1},{"@type":"ListItem","name":"Color","item":"https://exploreswiftui.com/library/color","position":2},{"@type":"ListItem","name":"Color Variants","item":"https://exploreswiftui.com/library/color/color-variants","position":3}]},{"@id":"https://exploreswiftui.com/#logo","@type":"ImageObject","caption":"Explore SwiftUI","contentUrl":"https://exploreswiftui.com/apple-touch-icon.png","inLanguage":"en","url":"https://exploreswiftui.com/apple-touch-icon.png"},{"@id":"https://exploreswiftui.com/#/schema/image/1","@type":"ImageObject","contentUrl":"https://exploreswiftui.com/api/images/9/variants/209?v=1790073478842&r=2","inLanguage":"en","url":"https://exploreswiftui.com/api/images/9/variants/209?v=1790073478842&r=2"}]} ```