---
title: "ControlSize | Explore SwiftUI"
description: "A control version that is the default size. Learn how to use ControlSize in SwiftUI with visual code examples for iOS, macOS, watchOS, tvOS, and visionOS."
canonical_url: "https://exploreswiftui.com/library/view/controlsize"
meta:
  author: "Explore SwiftUI"
  "og:description": "A control version that is the default size. Learn how to use ControlSize in SwiftUI with visual code examples for iOS, macOS, watchOS, tvOS, and visionOS."
  "og:image": "https://exploreswiftui.com/_og/d/c_Component%2Ctitle_ControlSize%2Cdescription_A%2Bcontrol%2Bversion%2Bthat%2Bis%2Bthe%2Bdefault%2Bsize%2Ccategory_View%2Cimage_~L2FwaS9pbWFnZXMvOTcvdmFyaWFudHMvMzAzP3Y9MTc5MDA3MzQ3ODg0MiZyPTImdz0xMjgwJnE9ODUmZj1qcGVn%2CimageMode_crop%2CimagePosition_center%2CimageFrame_~cG9zaXRpb246IGFic29sdXRlOyByaWdodDogMDsgd2lkdGg6IDY0MHB4OyBoZWlnaHQ6IDQ4MHB4OyBkaXNwbGF5OiBmbGV4OyBvdmVyZmxvdzogaGlkZGVuOyBiYWNrZ3JvdW5kOiAjRkZGRkZGOyBib3gtc2hhZG93OiAwIC0xMHB4IDUwcHggcmdiYSgzNyw5OSwyMzUsMC4xOCk7IGJvcmRlci1sZWZ0OiAxcHggc29saWQgcmdiYSgwLDAsMCwwLjA2KTsgdG9wOiA3NXB4OyBib3JkZXItdG9wOiAxcHggc29saWQgcmdiYSgwLDAsMCwwLjA2KTsgYm9yZGVyLWJvdHRvbTogMXB4IHNvbGlkIHJnYmEoMCwwLDAsMC4wNik7IGJvcmRlci10b3AtbGVmdC1yYWRpdXM6IDMycHg7IGJvcmRlci1ib3R0b20tbGVmdC1yYWRpdXM6IDMycHg7%2Cprops_eyJwbGF0Zm9ybXMiOlsiaU9TIiwiaVBhZE9TIiwibWFjT1MiLCJ3YXRjaE9TIiwidHZPUyIsInZpc2lvbk9TIl19%2Cp_Ii9saWJyYXJ5L3ZpZXcvY29udHJvbHNpemUi%2Cs_AII8J06UmabBK-Os.png"
  "og:image:height": "630"
  "og:image:type": image/png
  "og:image:width": "1200"
  "og:title": "ControlSize | Explore SwiftUI"
  "twitter:description": "A control version that is the default size. Learn how to use ControlSize in SwiftUI with visual code examples for iOS, macOS, watchOS, tvOS, and visionOS."
  "twitter:image": "https://exploreswiftui.com/_og/d/c_Component%2Ctitle_ControlSize%2Cdescription_A%2Bcontrol%2Bversion%2Bthat%2Bis%2Bthe%2Bdefault%2Bsize%2Ccategory_View%2Cimage_~L2FwaS9pbWFnZXMvOTcvdmFyaWFudHMvMzAzP3Y9MTc5MDA3MzQ3ODg0MiZyPTImdz0xMjgwJnE9ODUmZj1qcGVn%2CimageMode_crop%2CimagePosition_center%2CimageFrame_~cG9zaXRpb246IGFic29sdXRlOyByaWdodDogMDsgd2lkdGg6IDY0MHB4OyBoZWlnaHQ6IDQ4MHB4OyBkaXNwbGF5OiBmbGV4OyBvdmVyZmxvdzogaGlkZGVuOyBiYWNrZ3JvdW5kOiAjRkZGRkZGOyBib3gtc2hhZG93OiAwIC0xMHB4IDUwcHggcmdiYSgzNyw5OSwyMzUsMC4xOCk7IGJvcmRlci1sZWZ0OiAxcHggc29saWQgcmdiYSgwLDAsMCwwLjA2KTsgdG9wOiA3NXB4OyBib3JkZXItdG9wOiAxcHggc29saWQgcmdiYSgwLDAsMCwwLjA2KTsgYm9yZGVyLWJvdHRvbTogMXB4IHNvbGlkIHJnYmEoMCwwLDAsMC4wNik7IGJvcmRlci10b3AtbGVmdC1yYWRpdXM6IDMycHg7IGJvcmRlci1ib3R0b20tbGVmdC1yYWRpdXM6IDMycHg7%2Cprops_eyJwbGF0Zm9ybXMiOlsiaU9TIiwiaVBhZE9TIiwibWFjT1MiLCJ3YXRjaE9TIiwidHZPUyIsInZpc2lvbk9TIl19%2Cp_Ii9saWJyYXJ5L3ZpZXcvY29udHJvbHNpemUi%2Cs_AII8J06UmabBK-Os.png"
  "twitter:title": "ControlSize | Explore SwiftUI"
---

> Index of every page on this site: [llms.txt](https://exploreswiftui.com/llms.txt)

**Interactive previews**[ iPhone](https://exploreswiftui.com/iphone?element=97)

# **ControlSize**

A control version that is the default size

![ControlSize - iOS on iPhone - Portrait - Liquid Glass - Light Mode - Preview](https://exploreswiftui.com/api/images/97/variants/303?v=1790073478842&r=2&w=800&q=80&f=webp)

### **Platform Compatibility**

iOS 15.0+ iPadOS 15.0+ macOS 10.15+ watchOS 9.0+ tvOS 15.0+ visionOS 1.0+

### **Tags**

### **SwiftUI Code**

[ Docs](https://developer.apple.com/documentation/swiftui/controlsize/regular)

```
VStack {
    Button("Tap Me", action: action)
        .buttonStyle(.borderedProminent)
        .controlSize(.mini)
    Button("Tap Me", action: action)
        .buttonStyle(.borderedProminent)
        .controlSize(.small)
    Button("Tap Me", action: action)
        .buttonStyle(.borderedProminent)
        .controlSize(.regular)
    Button("Tap Me", action: action)
        .buttonStyle(.borderedProminent)
        .controlSize(.large)
    Button("Tap Me", action: action)
        .buttonStyle(.borderedProminent)
    // only on visionOS bigger than large
        .controlSize(.extraLarge)

}
```

### **Found an issue or have a suggestion?**

Created: June 12, 2025Updated: December 27, 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 View Components **

[**View all **](https://exploreswiftui.com/library/view)

![VisionOS background materials - visionOS - Liquid Glass - Light Mode - Preview](https://exploreswiftui.com/api/images/260/variants/2143?v=1793707679045&r=2&w=412&q=75&f=webp)

### **VisionOS background materials**

All background materials on visionOS

![Container Content Margins - iOS on iPhone - Portrait - Liquid Glass - Light Mode - Preview](https://exploreswiftui.com/api/images/257/variants/1987?v=1792070676534&r=2&w=412&q=75&f=webp)

### **Container Content Margins**

Adds the margins of the container the view is in.

![Toolbar Vertical Edge - iOS on iPhone - Portrait - Liquid Glass - Light Mode - Preview](https://exploreswiftui.com/api/images/254/variants/1863?v=1790589836833&r=2&w=412&q=75&f=webp)

### **Toolbar Vertical Edge**

This value reflects the system’s preferred edge for the vertical bar in the current context, regardless of whether a vertical bar is currently visible. Use it to position custom bars or other UI relative to the system’s bar placement.

![Hinge State - iOS on iPhone Duo - Landscape - Fully Open - Liquid Glass - Light Mode - Preview](https://exploreswiftui.com/api/images/249/variants/1765?v=1793099575627&r=2&w=412&q=75&f=webp)

### **Hinge State**

A type encapsulating the state of a single hinge.

![Disabled Toolbar Vertical Behavior - iOS on iPhone Duo - Landscape - Fully Open - Liquid Glass - Light Mode - Preview](https://exploreswiftui.com/api/images/246/variants/1636?v=1790277107518&r=2&w=412&q=75&f=webp)

### **Disabled Toolbar Vertical Behavior**

Disables the vertical bar.

![Music Picker - iOS on iPhone - Portrait - Liquid Glass - Light Mode - Preview](https://exploreswiftui.com/api/images/232/variants/727?v=1790073478842&r=2&w=412&q=75&f=webp)

### **Music Picker**

Presents a music picker to select items from the Apple Music catalog and the user’s music library.

![App Store Overlay - iOS on iPhone - Portrait - Liquid Glass - Light Mode - Preview](https://exploreswiftui.com/api/images/224/variants/269?v=1790073478842&r=2&w=412&q=75&f=webp)

### **App Store Overlay**

Presents a StoreKit overlay when a given condition is true.

![Manage Subscriptions Sheet - iOS on iPhone - Portrait - Liquid Glass - Light Mode - Preview](https://exploreswiftui.com/api/images/223/variants/241?v=1790073478842&r=2&w=412&q=75&f=webp)

### **Manage Subscriptions Sheet**

Opens the manage subscriptions sheet.

### **Explore Other Components **

[**Browse all **](https://exploreswiftui.com/)

![Future DatePicker - iOS on iPhone - Portrait - Liquid Glass - Light Mode - Preview](https://exploreswiftui.com/api/images/68/variants/18?v=1790073478842&r=2&w=412&q=75&f=webp)

### **Future DatePicker**

Creates an instance that selects multiple dates on or after some start date

![Concentric Rectangle - iOS on iPhone - Portrait - Liquid Glass - Light Mode - Preview](https://exploreswiftui.com/api/images/153/variants/498?v=1790073478842&r=2&w=412&q=75&f=webp)

### **Concentric Rectangle**

A concentric rectangle whose corner radii are defined from the same circle center as its parent element. The outermost parent is the device frame.

![Placeholder Icon Store View - iOS on iPhone - Portrait - Liquid Glass - Light Mode - Preview](https://exploreswiftui.com/api/images/215/variants/653?v=1790073478842&r=2&w=412&q=75&f=webp)

### **Placeholder Icon Store View**

Creates a view to load a collection of products from the App Store using product identifiers, and merchandise them using an image and a custom placeholder icon.

![GroupBox Background - iOS on iPhone - Portrait - Liquid Glass - Light Mode - Preview](https://exploreswiftui.com/api/images/29/variants/190?v=1790073478842&r=2&w=412&q=75&f=webp)

### **GroupBox Background**

Set a custom GroupBox background

![Custom Group Subscription Store View - iOS on iPhone - Portrait - Liquid Glass - Light Mode - Preview](https://exploreswiftui.com/api/images/230/variants/667?v=1790073478842&r=2&w=412&q=75&f=webp)

### **Custom Group Subscription Store View**

Creates a SubscriptionStoreView with custom grouping.

![Sheet Corner Radius - iOS on iPhone - Portrait - Liquid Glass - Light Mode - Preview](https://exploreswiftui.com/api/images/142/variants/468?v=1790073478842&r=2&w=412&q=75&f=webp)

### **Sheet Corner Radius**

Requests that the presentation have a specific corner radius.

![Hide Sidebar Toggle - iOS on iPhone Duo - Landscape - Fully Open - Liquid Glass - Light Mode - Preview](https://exploreswiftui.com/api/images/255/variants/1925?v=1791377398818&r=2&w=412&q=75&f=webp)

### **Hide Sidebar Toggle**

Removes the sidebar toggle toolbar item a NavigationSplitView adds by default.

![Tab View Side Bar Header - iPadOS - Landscape - Liquid Glass - Light Mode - Preview](https://exploreswiftui.com/api/images/167/variants/729?v=1790073478842&r=2&w=412&q=75&f=webp)

### **Tab View Side Bar Header**

Adds a custom header to the sidebar of a tab view.

```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/view/controlsize#webpage","@type":"WebPage","dateModified":"2025-12-27T19:25:22.758Z","datePublished":"2025-06-12T16:20:04.740Z","description":"A control version that is the default size. Learn how to use ControlSize in SwiftUI with visual code examples for iOS, macOS, watchOS, tvOS, and visionOS.","name":"ControlSize","url":"https://exploreswiftui.com/library/view/controlsize","breadcrumb":{"@id":"https://exploreswiftui.com/library/view/controlsize#breadcrumb"},"isPartOf":{"@id":"https://exploreswiftui.com/#website"},"potentialAction":[{"@type":"ReadAction","target":["https://exploreswiftui.com/library/view/controlsize"]}],"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/view/controlsize#article","dateModified":"2025-12-27T19:25:22.758Z","datePublished":"2025-06-12T16:20:04.740Z","description":"A control version that is the default size. Learn how to use ControlSize in SwiftUI with visual code examples for iOS, macOS, watchOS, tvOS, and visionOS.","headline":"ControlSize","inLanguage":"en-US","name":"ControlSize","thumbnailUrl":"https://exploreswiftui.com/api/images/97/variants/303?v=1790073478842&r=2","url":"https://exploreswiftui.com/library/view/controlsize","@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/view/controlsize#webpage"},"publisher":{"@id":"https://exploreswiftui.com/#identity"}},{"@id":"https://exploreswiftui.com/library/view/controlsize#/schema/software-source-code/1","@type":"SoftwareSourceCode","codeRepository":"https://developer.apple.com/documentation/swiftui/controlsize/regular","codeSampleType":"full example","description":"A control version that is the default size. Learn how to use ControlSize in SwiftUI with visual code examples for iOS, macOS, watchOS, tvOS, and visionOS.","name":"ControlSize SwiftUI Example","programmingLanguage":"Swift","runtimePlatform":"SwiftUI","text":"VStack {\n    Button(\"Tap Me\", action: action)\n        .buttonStyle(.borderedProminent)\n        .controlSize(.mini)\n    Button(\"Tap Me\", action: action)\n        .buttonStyle(.borderedProminent)\n        .controlSize(.small)\n    Button(\"Tap Me\", action: action)\n        .buttonStyle(.borderedProminent)\n        .controlSize(.regular)\n    Button(\"Tap Me\", action: action)\n        .buttonStyle(.borderedProminent)\n        .controlSize(.large)\n    Button(\"Tap Me\", action: action)\n        .buttonStyle(.borderedProminent)\n    // only on visionOS bigger than large\n        .controlSize(.extraLarge)\n\n}\n","about":[{"@type":"Thing","name":"SwiftUI"},{"@type":"Thing","name":"View"},{"@type":"Thing","name":"ControlSize"}]},{"@id":"https://exploreswiftui.com/library/view/controlsize#breadcrumb","@type":"BreadcrumbList","itemListElement":[{"@type":"ListItem","name":"Home","item":"https://exploreswiftui.com","position":1},{"@type":"ListItem","name":"View","item":"https://exploreswiftui.com/library/view","position":2},{"@type":"ListItem","name":"ControlSize","item":"https://exploreswiftui.com/library/view/controlsize","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/97/variants/303?v=1790073478842&r=2","inLanguage":"en","url":"https://exploreswiftui.com/api/images/97/variants/303?v=1790073478842&r=2"}]}
```