--- title: "RenameButton | Explore SwiftUI" description: "A button that triggers a standard rename action. Learn how to use RenameButton in SwiftUI with visual code examples for iOS, macOS, watchOS, tvOS, and visionOS." canonical_url: "https://exploreswiftui.com/library/button/renamebutton" meta: author: "Explore SwiftUI" "og:description": "A button that triggers a standard rename action. Learn how to use RenameButton in SwiftUI with visual code examples for iOS, macOS, watchOS, tvOS, and visionOS." "og:image": "https://exploreswiftui.com/_og/d/c_Component%2Ctitle_RenameButton%2Cdescription_A%2Bbutton%2Bthat%2Btriggers%2Ba%2Bstandard%2Brename%2Baction%2Ccategory_Button%2Cimage_~L2FwaS9pbWFnZXMvMzcvdmFyaWFudHMvMjEzP3Y9MTc5MDA3MzQ3ODg0MiZyPTImdz0xMjgwJnE9ODUmZj1qcGVn%2CimageMode_crop%2CimagePosition_center%2CimageFrame_~cG9zaXRpb246IGFic29sdXRlOyByaWdodDogMDsgd2lkdGg6IDY0MHB4OyBoZWlnaHQ6IDQ4MHB4OyBkaXNwbGF5OiBmbGV4OyBvdmVyZmxvdzogaGlkZGVuOyBiYWNrZ3JvdW5kOiAjRkZGRkZGOyBib3gtc2hhZG93OiAwIC0xMHB4IDUwcHggcmdiYSgzNyw5OSwyMzUsMC4xOCk7IGJvcmRlci1sZWZ0OiAxcHggc29saWQgcmdiYSgwLDAsMCwwLjA2KTsgdG9wOiA3NXB4OyBib3JkZXItdG9wOiAxcHggc29saWQgcmdiYSgwLDAsMCwwLjA2KTsgYm9yZGVyLWJvdHRvbTogMXB4IHNvbGlkIHJnYmEoMCwwLDAsMC4wNik7IGJvcmRlci10b3AtbGVmdC1yYWRpdXM6IDMycHg7IGJvcmRlci1ib3R0b20tbGVmdC1yYWRpdXM6IDMycHg7%2Cprops_eyJwbGF0Zm9ybXMiOlsiaU9TIiwiaVBhZE9TIiwibWFjT1MiLCJ3YXRjaE9TIiwidHZPUyIsInZpc2lvbk9TIl19%2Cp_Ii9saWJyYXJ5L2J1dHRvbi9yZW5hbWVidXR0b24i%2Cs_n0lS2fBPufXN2ect.png" "og:image:height": "630" "og:image:type": image/png "og:image:width": "1200" "og:title": "RenameButton | Explore SwiftUI" "twitter:description": "A button that triggers a standard rename action. Learn how to use RenameButton in SwiftUI with visual code examples for iOS, macOS, watchOS, tvOS, and visionOS." "twitter:image": "https://exploreswiftui.com/_og/d/c_Component%2Ctitle_RenameButton%2Cdescription_A%2Bbutton%2Bthat%2Btriggers%2Ba%2Bstandard%2Brename%2Baction%2Ccategory_Button%2Cimage_~L2FwaS9pbWFnZXMvMzcvdmFyaWFudHMvMjEzP3Y9MTc5MDA3MzQ3ODg0MiZyPTImdz0xMjgwJnE9ODUmZj1qcGVn%2CimageMode_crop%2CimagePosition_center%2CimageFrame_~cG9zaXRpb246IGFic29sdXRlOyByaWdodDogMDsgd2lkdGg6IDY0MHB4OyBoZWlnaHQ6IDQ4MHB4OyBkaXNwbGF5OiBmbGV4OyBvdmVyZmxvdzogaGlkZGVuOyBiYWNrZ3JvdW5kOiAjRkZGRkZGOyBib3gtc2hhZG93OiAwIC0xMHB4IDUwcHggcmdiYSgzNyw5OSwyMzUsMC4xOCk7IGJvcmRlci1sZWZ0OiAxcHggc29saWQgcmdiYSgwLDAsMCwwLjA2KTsgdG9wOiA3NXB4OyBib3JkZXItdG9wOiAxcHggc29saWQgcmdiYSgwLDAsMCwwLjA2KTsgYm9yZGVyLWJvdHRvbTogMXB4IHNvbGlkIHJnYmEoMCwwLDAsMC4wNik7IGJvcmRlci10b3AtbGVmdC1yYWRpdXM6IDMycHg7IGJvcmRlci1ib3R0b20tbGVmdC1yYWRpdXM6IDMycHg7%2Cprops_eyJwbGF0Zm9ybXMiOlsiaU9TIiwiaVBhZE9TIiwibWFjT1MiLCJ3YXRjaE9TIiwidHZPUyIsInZpc2lvbk9TIl19%2Cp_Ii9saWJyYXJ5L2J1dHRvbi9yZW5hbWVidXR0b24i%2Cs_n0lS2fBPufXN2ect.png" "twitter:title": "RenameButton | Explore SwiftUI" --- > Index of every page on this site: [llms.txt](https://exploreswiftui.com/llms.txt) **Interactive previews**[ iPhone](https://exploreswiftui.com/iphone?element=37) # **RenameButton** A button that triggers a standard rename action ![RenameButton - iOS on iPhone - Portrait - Liquid Glass - Light Mode - Preview](https://exploreswiftui.com/api/images/37/variants/213?v=1790073478842&r=2&w=800&q=80&f=webp) ### **Platform Compatibility** iOS 16.0+ iPadOS 16.0+ macOS 13.0+ watchOS 9.0+ tvOS 16.0+ visionOS 1.0+ ### **Tags** ### **SwiftUI Code** [ Docs](https://developer.apple.com/documentation/swiftui/renamebutton) ``` @State private var text = "foo" var body: some View { HStack { Text(text) RenameButton() .padding(.leading) .renameAction { text = "bar" } } } ``` ### **Found an issue or have a suggestion?** Created: June 3, 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 Button Components ** [**View all **](https://exploreswiftui.com/library/button) ![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. ![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. ![Glass Button Styles - iOS on iPhone - Portrait - Liquid Glass - Light Mode - Preview](https://exploreswiftui.com/api/images/87/variants/314?v=1790073478842&r=2&w=412&q=75&f=webp) ### **Glass Button Styles** A button style that applies glass border artwork based on the button’s context ![EditButton - iOS on iPhone - Portrait - Liquid Glass - Light Mode - Preview](https://exploreswiftui.com/api/images/36/variants/239?v=1790073478842&r=2&w=412&q=75&f=webp) ### **EditButton** A button that toggles the edit mode environment value ![PasteButton - iOS on iPhone - Portrait - Liquid Glass - Light Mode - Preview](https://exploreswiftui.com/api/images/35/variants/235?v=1790073478842&r=2&w=412&q=75&f=webp) ### **PasteButton** A system button that reads items from the pasteboard and delivers it to a closure. ![Button Tint - iOS on iPhone - Portrait - Liquid Glass - Light Mode - Preview](https://exploreswiftui.com/api/images/34/variants/408?v=1790073478842&r=2&w=412&q=75&f=webp) ### **Button Tint** Sets the buttons tint color ![Button Roles - iOS on iPhone - Portrait - Liquid Glass - Light Mode - Preview](https://exploreswiftui.com/api/images/33/variants/718?v=1790073478842&r=2&w=412&q=75&f=webp) ### **Button Roles** A value that describes the purpose of a button. ![Button Border Shape - iOS on iPhone - Portrait - Liquid Glass - Light Mode - Preview](https://exploreswiftui.com/api/images/32/variants/179?v=1790073478842&r=2&w=412&q=75&f=webp) ### **Button Border Shape** A shape used to draw a button’s border. ### **Explore Other Components ** [**Browse all **](https://exploreswiftui.com/) ![ToolbarItem Shared Background Visibility - iOS on iPhone - Portrait - Liquid Glass - Light Mode - Preview](https://exploreswiftui.com/api/images/92/variants/295?v=1790073478842&r=2&w=412&q=75&f=webp) ### **ToolbarItem Shared Background Visibility** Controls the visibility of the glass background effect on items in the toolbar. In certain contexts, such as the navigation bar on iOS and the window toolbar on macOS, toolbar items will be given a glass background effect that is shared with other items in the same logical grouping ![CarouselListStyle - watchOS - Flat Design - Light Mode - Preview](https://exploreswiftui.com/api/images/102/variants/328?v=1790073478842&r=2&w=412&q=75&f=webp) ### **CarouselListStyle** The carousel list style. ![BorderedListStyle - macOS - Flat Design - Light Mode - Preview](https://exploreswiftui.com/api/images/101/variants/308?v=1790073478842&r=2&w=412&q=75&f=webp) ### **BorderedListStyle** The list style that describes the behavior and appearance of a list with standard border. ![Section Index Label and Visibility - iOS on iPhone - Portrait - Liquid Glass - Light Mode - Preview](https://exploreswiftui.com/api/images/129/variants/369?v=1790073478842&r=2&w=412&q=75&f=webp) ### **Section Index Label and Visibility** Sets the label that is used in a section index to point to this section, typically only a single character long. Changes the visibility of the list section index. ![ToolbarSpacer - iOS on iPhone - Portrait - Liquid Glass - Light Mode - Preview](https://exploreswiftui.com/api/images/82/variants/106?v=1790073478842&r=2&w=412&q=75&f=webp) ### **ToolbarSpacer** A standard space item in toolbars ![CircularGaugeStyle - iOS on iPhone - Portrait - Flat Design - Light Mode - Preview](https://exploreswiftui.com/api/images/47/variants/263?v=1790073478842&r=2&w=412&q=75&f=webp) ### **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 ![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. ![StepperFieldDatePickerStyle - macOS - Flat Design - Light Mode - Preview](https://exploreswiftui.com/api/images/64/variants/96?v=1790073478842&r=2&w=412&q=75&f=webp) ### **StepperFieldDatePickerStyle** A system style that displays the components in an editable field, with adjoining stepper that can increment/decrement the selected component ```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/button/renamebutton#webpage","@type":"WebPage","dateModified":"2025-12-27T17:43:10.516Z","datePublished":"2025-06-03T15:17:49.393Z","description":"A button that triggers a standard rename action. Learn how to use RenameButton in SwiftUI with visual code examples for iOS, macOS, watchOS, tvOS, and visionOS.","name":"RenameButton","url":"https://exploreswiftui.com/library/button/renamebutton","breadcrumb":{"@id":"https://exploreswiftui.com/library/button/renamebutton#breadcrumb"},"isPartOf":{"@id":"https://exploreswiftui.com/#website"},"potentialAction":[{"@type":"ReadAction","target":["https://exploreswiftui.com/library/button/renamebutton"]}],"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/button/renamebutton#article","dateModified":"2025-12-27T17:43:10.516Z","datePublished":"2025-06-03T15:17:49.393Z","description":"A button that triggers a standard rename action. Learn how to use RenameButton in SwiftUI with visual code examples for iOS, macOS, watchOS, tvOS, and visionOS.","headline":"RenameButton","inLanguage":"en-US","name":"RenameButton","thumbnailUrl":"https://exploreswiftui.com/api/images/37/variants/213?v=1790073478842&r=2","url":"https://exploreswiftui.com/library/button/renamebutton","@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/button/renamebutton#webpage"},"publisher":{"@id":"https://exploreswiftui.com/#identity"}},{"@id":"https://exploreswiftui.com/library/button/renamebutton#/schema/software-source-code/1","@type":"SoftwareSourceCode","codeRepository":"https://developer.apple.com/documentation/swiftui/renamebutton","codeSampleType":"full example","description":"A button that triggers a standard rename action. Learn how to use RenameButton in SwiftUI with visual code examples for iOS, macOS, watchOS, tvOS, and visionOS.","name":"RenameButton SwiftUI Example","programmingLanguage":"Swift","runtimePlatform":"SwiftUI","text":"@State private var text = \"foo\"\n\nvar body: some View {\n HStack {\n Text(text)\n\n RenameButton()\n .padding(.leading)\n .renameAction {\n text = \"bar\"\n }\n }\n }","about":[{"@type":"Thing","name":"SwiftUI"},{"@type":"Thing","name":"Button"},{"@type":"Thing","name":"RenameButton"}]},{"@id":"https://exploreswiftui.com/library/button/renamebutton#breadcrumb","@type":"BreadcrumbList","itemListElement":[{"@type":"ListItem","name":"Home","item":"https://exploreswiftui.com","position":1},{"@type":"ListItem","name":"Button","item":"https://exploreswiftui.com/library/button","position":2},{"@type":"ListItem","name":"RenameButton","item":"https://exploreswiftui.com/library/button/renamebutton","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/37/variants/213?v=1790073478842&r=2","inLanguage":"en","url":"https://exploreswiftui.com/api/images/37/variants/213?v=1790073478842&r=2"}]} ```