--- title: "CircularGaugeStyle | Explore SwiftUI" description: "A gauge style that displays an open ring with a marker that appears at a point along the ring to indicate the gauge’s current value" canonical_url: "https://exploreswiftui.com/library/gauge/circulargaugestyle" meta: author: "Explore SwiftUI" "og:description": "A gauge style that displays an open ring with a marker that appears at a point along the ring to indicate the gauge’s current value" "og:image": "https://exploreswiftui.com/_og/d/c_Component%2Ctitle_CircularGaugeStyle%2Cdescription_~QSBnYXVnZSBzdHlsZSB0aGF0IGRpc3BsYXlzIGFuIG9wZW4gcmluZyB3aXRoIGEgbWFya2VyIHRoYXQgYXBwZWFycyBhdCBhIHBvaW50IGFsb25nIHRoZSByaW5nIHRvIGluZGljYXRlIHRoZSBnYXVnZeKAmXMgY3VycmVudCB2YWx1ZQ%2Ccategory_Gauge%2Cimage_~L2FwaS9pbWFnZXMvNDcvdmFyaWFudHMvMjYzP3Y9MTc5MDA3MzQ3ODg0MiZyPTImdz0xMjgwJnE9ODUmZj1qcGVn%2CimageMode_crop%2CimagePosition_center%2CimageFrame_~cG9zaXRpb246IGFic29sdXRlOyByaWdodDogMDsgd2lkdGg6IDY0MHB4OyBoZWlnaHQ6IDQ4MHB4OyBkaXNwbGF5OiBmbGV4OyBvdmVyZmxvdzogaGlkZGVuOyBiYWNrZ3JvdW5kOiAjRkZGRkZGOyBib3gtc2hhZG93OiAwIC0xMHB4IDUwcHggcmdiYSgzNyw5OSwyMzUsMC4xOCk7IGJvcmRlci1sZWZ0OiAxcHggc29saWQgcmdiYSgwLDAsMCwwLjA2KTsgdG9wOiA3NXB4OyBib3JkZXItdG9wOiAxcHggc29saWQgcmdiYSgwLDAsMCwwLjA2KTsgYm9yZGVyLWJvdHRvbTogMXB4IHNvbGlkIHJnYmEoMCwwLDAsMC4wNik7IGJvcmRlci10b3AtbGVmdC1yYWRpdXM6IDMycHg7IGJvcmRlci1ib3R0b20tbGVmdC1yYWRpdXM6IDMycHg7%2Cprops_eyJwbGF0Zm9ybXMiOlsid2F0Y2hPUyJdfQ%2Cp_Ii9saWJyYXJ5L2dhdWdlL2NpcmN1bGFyZ2F1Z2VzdHlsZSI%2Cs_F3g1Ih9jDak2ks8r.png" "og:image:height": "630" "og:image:type": image/png "og:image:width": "1200" "og:title": "CircularGaugeStyle | Explore SwiftUI" "twitter:description": "A gauge style that displays an open ring with a marker that appears at a point along the ring to indicate the gauge’s current value" "twitter:image": "https://exploreswiftui.com/_og/d/c_Component%2Ctitle_CircularGaugeStyle%2Cdescription_~QSBnYXVnZSBzdHlsZSB0aGF0IGRpc3BsYXlzIGFuIG9wZW4gcmluZyB3aXRoIGEgbWFya2VyIHRoYXQgYXBwZWFycyBhdCBhIHBvaW50IGFsb25nIHRoZSByaW5nIHRvIGluZGljYXRlIHRoZSBnYXVnZeKAmXMgY3VycmVudCB2YWx1ZQ%2Ccategory_Gauge%2Cimage_~L2FwaS9pbWFnZXMvNDcvdmFyaWFudHMvMjYzP3Y9MTc5MDA3MzQ3ODg0MiZyPTImdz0xMjgwJnE9ODUmZj1qcGVn%2CimageMode_crop%2CimagePosition_center%2CimageFrame_~cG9zaXRpb246IGFic29sdXRlOyByaWdodDogMDsgd2lkdGg6IDY0MHB4OyBoZWlnaHQ6IDQ4MHB4OyBkaXNwbGF5OiBmbGV4OyBvdmVyZmxvdzogaGlkZGVuOyBiYWNrZ3JvdW5kOiAjRkZGRkZGOyBib3gtc2hhZG93OiAwIC0xMHB4IDUwcHggcmdiYSgzNyw5OSwyMzUsMC4xOCk7IGJvcmRlci1sZWZ0OiAxcHggc29saWQgcmdiYSgwLDAsMCwwLjA2KTsgdG9wOiA3NXB4OyBib3JkZXItdG9wOiAxcHggc29saWQgcmdiYSgwLDAsMCwwLjA2KTsgYm9yZGVyLWJvdHRvbTogMXB4IHNvbGlkIHJnYmEoMCwwLDAsMC4wNik7IGJvcmRlci10b3AtbGVmdC1yYWRpdXM6IDMycHg7IGJvcmRlci1ib3R0b20tbGVmdC1yYWRpdXM6IDMycHg7%2Cprops_eyJwbGF0Zm9ybXMiOlsid2F0Y2hPUyJdfQ%2Cp_Ii9saWJyYXJ5L2dhdWdlL2NpcmN1bGFyZ2F1Z2VzdHlsZSI%2Cs_F3g1Ih9jDak2ks8r.png" "twitter:title": "CircularGaugeStyle | Explore SwiftUI" --- > Index of every page on this site: [llms.txt](https://exploreswiftui.com/llms.txt) **Interactive previews**[ iPhone](https://exploreswiftui.com/iphone?element=47) # **CircularGaugeStyle** A gauge style that displays an open ring with a marker that appears at a point along the ring to indicate the gauge’s current value ![CircularGaugeStyle - iOS on iPhone - Portrait - Flat Design - Light Mode - Preview](https://exploreswiftui.com/api/images/47/variants/263?v=1790073478842&r=2&w=800&q=80&f=webp) ### **Platform Compatibility** watchOS 7.0+ ### **Tags** ### **SwiftUI Code** [ Docs](https://developer.apple.com/documentation/swiftui/gaugestyle/circular) ``` @State private var currentValue = 0.42 var body: some View { HStack { Gauge(value: 0.42) { Text("Foo") } Gauge(value: currentValue) { Text("Foo") } currentValueLabel: { Text("\(currentValue)") } .padding(.horizontal) Gauge(value: currentValue) { Text("Foo") } currentValueLabel: { Text("42") } minimumValueLabel: { Text("0") } maximumValueLabel: { Text("100") } } .gaugeStyle(.circular) } ``` ### **Found an issue or have a suggestion?** Created: June 3, 2025Updated: June 3, 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 Gauge Components ** [**View all **](https://exploreswiftui.com/library/gauge) ![Gauge Colors - iOS on iPhone - Portrait - Liquid Glass - Light Mode - Preview](https://exploreswiftui.com/api/images/48/variants/261?v=1790073478842&r=2&w=412&q=75&f=webp) ### **Gauge Colors** Customizing the colors of different styles with minimal effort ![ LinearGaugeStyle - iOS on iPhone - Portrait - Flat Design - Light Mode - Preview](https://exploreswiftui.com/api/images/46/variants/264?v=1790073478842&r=2&w=412&q=75&f=webp) ### **LinearGaugeStyle** A gauge style that displays a bar with a marker that appears at a point along the bar to indicate the gauge’s current value ![AccessoryLinearCapacityGaugeStyle - iOS on iPhone - Portrait - Liquid Glass - Light Mode - Preview](https://exploreswiftui.com/api/images/45/variants/257?v=1790073478842&r=2&w=412&q=75&f=webp) ### **AccessoryLinearCapacityGaugeStyle** A gauge style that displays bar that fills from leading to trailing edges as the gauge’s current value increases ![AccessoryLinearGaugeStyle - iOS on iPhone - Portrait - Liquid Glass - Light Mode - Preview](https://exploreswiftui.com/api/images/44/variants/253?v=1790073478842&r=2&w=412&q=75&f=webp) ### **AccessoryLinearGaugeStyle** A gauge style that displays bar with a marker that appears at a point along the bar to indicate the gauge’s current value ![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 ![AccessoryCircularCapacityGaugeStyle - iOS on iPhone - Portrait - Liquid Glass - Light Mode - Preview](https://exploreswiftui.com/api/images/42/variants/412?v=1790073478842&r=2&w=412&q=75&f=webp) ### **AccessoryCircularCapacityGaugeStyle** A gauge style that displays a closed ring that’s partially filled in to indicate the gauge’s current value ![AccessoryCircularGaugeStyle - iOS on iPhone - Portrait - Liquid Glass - Light Mode - Preview](https://exploreswiftui.com/api/images/41/variants/219?v=1790073478842&r=2&w=412&q=75&f=webp) ### **AccessoryCircularGaugeStyle** A gauge style that displays an open ring with a marker that appears at a point along the ring to indicate the gauge’s current value ![Min Max Current Value Gauge - iOS on iPhone - Portrait - Liquid Glass - Light Mode - Preview](https://exploreswiftui.com/api/images/40/variants/231?v=1790073478842&r=2&w=412&q=75&f=webp) ### **Min Max Current Value Gauge** Creates a gauge showing a value within a range and describes the gauge’s current, minimum, and maximum values ### **Explore Other Components ** [**Browse all **](https://exploreswiftui.com/) ![Swipe Container - iOS on iPhone - Portrait - Liquid Glass - Light Mode - Preview](https://exploreswiftui.com/api/images/201/variants/496?v=1790073478842&r=2&w=412&q=75&f=webp) ### **Swipe Container** Only allows a single active swipe within a container. ![Button Sizing - iOS on iPhone - Portrait - Liquid Glass - Light Mode - Preview](https://exploreswiftui.com/api/images/190/variants/3?v=1790073478842&r=2&w=412&q=75&f=webp) ### **Button Sizing** The preferred sizing behavior of buttons in the view hierarchy. ![Slider Color - iOS on iPhone - Portrait - Liquid Glass - Light Mode - Preview](https://exploreswiftui.com/api/images/52/variants/335?v=1790073478842&r=2&w=412&q=75&f=webp) ### **Slider Color** Customizing the color of the slider ![Role Button With Default Label - iOS on iPhone - Portrait - Liquid Glass - Light Mode - Preview](https://exploreswiftui.com/api/images/134/variants/424?v=1790073478842&r=2&w=412&q=75&f=webp) ### **Role Button With Default Label** Creates a button that displays a default label. ![Title Toolbar Item Placement - iOS on iPhone - Portrait - Liquid Glass - Light Mode - Preview](https://exploreswiftui.com/api/images/95/variants/279?v=1790073478842&r=2&w=412&q=75&f=webp) ### **Title Toolbar Item Placement** Places content in the title area ![PalettePickerStyle - iOS on iPhone - Portrait - Liquid Glass - Light Mode - Preview](https://exploreswiftui.com/api/images/184/variants/598?v=1790073478842&r=2&w=412&q=75&f=webp) ### **PalettePickerStyle** A picker style that presents the options as a row of compact elements. When used outside of menus, this style is rendered as a segmented picker. If that is the intended usage, consider segmented instead. ![MultiDatePicker - iOS on iPhone - Portrait - Liquid Glass - Light Mode - Preview](https://exploreswiftui.com/api/images/67/variants/203?v=1790073478842&r=2&w=412&q=75&f=webp) ### **MultiDatePicker** A control for picking multiple dates. ![CircularProgressViewStyle - iOS on iPhone - Portrait - Liquid Glass - Light Mode - Preview](https://exploreswiftui.com/api/images/80/variants/86?v=1790073478842&r=2&w=412&q=75&f=webp) ### **CircularProgressViewStyle** The style of a progress view that uses a circular gauge to indicate the partial completion of an activity ```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/gauge/circulargaugestyle#webpage","@type":"WebPage","dateModified":"2025-06-03T19:59:37.713Z","datePublished":"2025-06-03T19:32:31.845Z","description":"A gauge style that displays an open ring with a marker that appears at a point along the ring to indicate the gauge’s current value","name":"CircularGaugeStyle","url":"https://exploreswiftui.com/library/gauge/circulargaugestyle","breadcrumb":{"@id":"https://exploreswiftui.com/library/gauge/circulargaugestyle#breadcrumb"},"isPartOf":{"@id":"https://exploreswiftui.com/#website"},"potentialAction":[{"@type":"ReadAction","target":["https://exploreswiftui.com/library/gauge/circulargaugestyle"]}],"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/gauge/circulargaugestyle#article","dateModified":"2025-06-03T19:59:37.713Z","datePublished":"2025-06-03T19:32:31.845Z","description":"A gauge style that displays an open ring with a marker that appears at a point along the ring to indicate the gauge’s current value","headline":"CircularGaugeStyle","inLanguage":"en-US","name":"CircularGaugeStyle","thumbnailUrl":"https://exploreswiftui.com/api/images/47/variants/263?v=1790073478842&r=2","url":"https://exploreswiftui.com/library/gauge/circulargaugestyle","@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/gauge/circulargaugestyle#webpage"},"publisher":{"@id":"https://exploreswiftui.com/#identity"}},{"@id":"https://exploreswiftui.com/library/gauge/circulargaugestyle#/schema/software-source-code/1","@type":"SoftwareSourceCode","codeRepository":"https://developer.apple.com/documentation/swiftui/gaugestyle/circular","codeSampleType":"full example","description":"A gauge style that displays an open ring with a marker that appears at a point along the ring to indicate the gauge’s current value","name":"CircularGaugeStyle SwiftUI Example","programmingLanguage":"Swift","runtimePlatform":"SwiftUI","text":"@State private var currentValue = 0.42\n\nvar body: some View {\n HStack {\n Gauge(value: 0.42) {\n Text(\"Foo\")\n }\n\n Gauge(value: currentValue) {\n Text(\"Foo\")\n } currentValueLabel: {\n Text(\"\\(currentValue)\")\n }\n .padding(.horizontal)\n\n Gauge(value: currentValue) {\n Text(\"Foo\")\n } currentValueLabel: {\n Text(\"42\")\n } minimumValueLabel: {\n Text(\"0\")\n } maximumValueLabel: {\n Text(\"100\")\n }\n }\n .gaugeStyle(.circular)\n}","about":[{"@type":"Thing","name":"SwiftUI"},{"@type":"Thing","name":"Gauge"},{"@type":"Thing","name":"CircularGaugeStyle"}]},{"@id":"https://exploreswiftui.com/library/gauge/circulargaugestyle#breadcrumb","@type":"BreadcrumbList","itemListElement":[{"@type":"ListItem","name":"Home","item":"https://exploreswiftui.com","position":1},{"@type":"ListItem","name":"Gauge","item":"https://exploreswiftui.com/library/gauge","position":2},{"@type":"ListItem","name":"CircularGaugeStyle","item":"https://exploreswiftui.com/library/gauge/circulargaugestyle","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/47/variants/263?v=1790073478842&r=2","inLanguage":"en","url":"https://exploreswiftui.com/api/images/47/variants/263?v=1790073478842&r=2"}]} ```