---
title: "On Primary Photos Picker Action | Explore SwiftUI"
description: "Sets the primary action handler for the Photos picker. Learn how to use On Primary Photos Picker Action in SwiftUI with visual code examples."
canonical_url: "https://exploreswiftui.com/library/photospicker/on-primary-photos-picker-action"
meta:
  author: "Explore SwiftUI"
  "og:description": "Sets the primary action handler for the Photos picker. Learn how to use On Primary Photos Picker Action in SwiftUI with visual code examples."
  "og:image": "https://exploreswiftui.com/_og/d/c_Component%2Ctitle_On%2BPrimary%2BPhotos%2BPicker%2BAction%2Cdescription_Sets%2Bthe%2Bprimary%2Baction%2Bhandler%2Bfor%2Bthe%2BPhotos%2Bpicker.%2Ccategory_PhotosPicker%2Cimage_~L2FwaS9pbWFnZXMvMjY3L3ZhcmlhbnRzLzIyNTE~dj0xNzk0OTEwNzg5ODUxJnI9MiZ3PTEyODAmcT04NSZmPWpwZWc%2CimageMode_crop%2CimagePosition_top%2CimageFrame_~cG9zaXRpb246IGFic29sdXRlOyByaWdodDogMDsgd2lkdGg6IDY0MHB4OyBoZWlnaHQ6IDQ4MHB4OyBkaXNwbGF5OiBmbGV4OyBvdmVyZmxvdzogaGlkZGVuOyBiYWNrZ3JvdW5kOiAjRkZGRkZGOyBib3gtc2hhZG93OiAwIC0xMHB4IDUwcHggcmdiYSgzNyw5OSwyMzUsMC4xOCk7IGJvcmRlci1sZWZ0OiAxcHggc29saWQgcmdiYSgwLDAsMCwwLjA2KTsgYm90dG9tOiAwOyBib3JkZXItdG9wOiAxcHggc29saWQgcmdiYSgwLDAsMCwwLjA2KTsgYm9yZGVyLXRvcC1sZWZ0LXJhZGl1czogNzRweDs%2Cprops_eyJwbGF0Zm9ybXMiOlsiaU9TIiwiaVBhZE9TIiwibWFjT1MiLCJ2aXNpb25PUyJdfQ%2Cp_Ii9saWJyYXJ5L3Bob3Rvc3BpY2tlci9vbi1wcmltYXJ5LXBob3Rvcy1waWNrZXItYWN0aW9uIg%2Cs_-wuxQX0dFA6G9Glp.png"
  "og:image:height": "630"
  "og:image:type": image/png
  "og:image:width": "1200"
  "og:title": "On Primary Photos Picker Action | Explore SwiftUI"
  "twitter:description": "Sets the primary action handler for the Photos picker. Learn how to use On Primary Photos Picker Action in SwiftUI with visual code examples."
  "twitter:image": "https://exploreswiftui.com/_og/d/c_Component%2Ctitle_On%2BPrimary%2BPhotos%2BPicker%2BAction%2Cdescription_Sets%2Bthe%2Bprimary%2Baction%2Bhandler%2Bfor%2Bthe%2BPhotos%2Bpicker.%2Ccategory_PhotosPicker%2Cimage_~L2FwaS9pbWFnZXMvMjY3L3ZhcmlhbnRzLzIyNTE~dj0xNzk0OTEwNzg5ODUxJnI9MiZ3PTEyODAmcT04NSZmPWpwZWc%2CimageMode_crop%2CimagePosition_top%2CimageFrame_~cG9zaXRpb246IGFic29sdXRlOyByaWdodDogMDsgd2lkdGg6IDY0MHB4OyBoZWlnaHQ6IDQ4MHB4OyBkaXNwbGF5OiBmbGV4OyBvdmVyZmxvdzogaGlkZGVuOyBiYWNrZ3JvdW5kOiAjRkZGRkZGOyBib3gtc2hhZG93OiAwIC0xMHB4IDUwcHggcmdiYSgzNyw5OSwyMzUsMC4xOCk7IGJvcmRlci1sZWZ0OiAxcHggc29saWQgcmdiYSgwLDAsMCwwLjA2KTsgYm90dG9tOiAwOyBib3JkZXItdG9wOiAxcHggc29saWQgcmdiYSgwLDAsMCwwLjA2KTsgYm9yZGVyLXRvcC1sZWZ0LXJhZGl1czogNzRweDs%2Cprops_eyJwbGF0Zm9ybXMiOlsiaU9TIiwiaVBhZE9TIiwibWFjT1MiLCJ2aXNpb25PUyJdfQ%2Cp_Ii9saWJyYXJ5L3Bob3Rvc3BpY2tlci9vbi1wcmltYXJ5LXBob3Rvcy1waWNrZXItYWN0aW9uIg%2Cs_-wuxQX0dFA6G9Glp.png"
  "twitter:title": "On Primary Photos Picker Action | Explore SwiftUI"
---

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

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

# **On Primary Photos Picker Action**

Sets the primary action handler for the Photos picker.

![On Primary Photos Picker Action - iOS on iPhone - Portrait - Liquid Glass - Light Mode - Preview](https://exploreswiftui.com/api/images/267/variants/2251?v=1794910789851&r=2&w=800&q=80&f=webp)

### **Platform Compatibility**

iOS 27.3+ iPadOS 27.3+ macOS 27.3+ visionOS 27.3+

### **Tags**

### **SwiftUI Code**

[ Docs](<https://developer.apple.com/documentation/SwiftUI/View/photosPickerOnPrimaryAction(_:)>)

```
@State private var selectedPhotos: [PhotosPickerItem] = []

var body: some View {
    PhotosPicker(
        "FooBar",
        selection: $selectedPhotos,
        selectionRange: 2 ... 5
    )
    .photosPickerOnPrimaryAction {
        print("selection confirmed")
    }
}
```

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

Created: November 17, 2026Updated: November 17, 2026

### **More PhotosPicker Components **

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

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

### **Photos Picker**

Creates a picker with a title key and selection, and optionally configures the types of items to show and item encoding behavior.

![Photos Picker Title - iPadOS - Landscape - Liquid Glass - Light Mode - Preview](https://exploreswiftui.com/api/images/270/variants/2261?v=1794910543223&r=2&w=412&q=75&f=webp)

### **Photos Picker Title**

Overrides the title of the Photos picker. The title is not visible on small screens, like the iPhone.

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

### **Photos Picker Prompt**

Sets the prompt of the Photos picker.

![On Secondary Photos Picker Action - iOS on iPhone - Portrait - Liquid Glass - Light Mode - Preview](https://exploreswiftui.com/api/images/268/variants/2255?v=1794910758520&r=2&w=412&q=75&f=webp)

### **On Secondary Photos Picker Action**

Sets the secondary action handler for the Photos picker.

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

### **Container Photo Picker**

Limits the Photos picker to only show items in the specified container. In this case, to the user-created album "CustomAlbum".

![Custom Photo Picker Buttons - iOS on iPhone - Portrait - Liquid Glass - Light Mode - Preview](https://exploreswiftui.com/api/images/265/variants/2235?v=1794910823065&r=2&w=412&q=75&f=webp)

### **Custom Photo Picker Buttons**

Sets the primary and secondary button types of the Photos picker.

![Disable Automatic Photos Picker Dismissal - iOS on iPhone - Portrait - Liquid Glass - Light Mode - Preview](https://exploreswiftui.com/api/images/264/variants/2231?v=1794910665768&r=2&w=412&q=75&f=webp)

### **Disable Automatic Photos Picker Dismissal**

Prevents the Photos picker from dismissing automatically. Without this modifier, the Photos picker would automatically dismiss when an image is tapped.

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

### **Range Photo Picker**

Presents a Photos picker that selects a collection of PhotosPickerItem, constrained to a range of selection counts.

### **Explore Other Components **

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

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

### **Slider**

Creates a slider to select a value from a given range

![Disclosure Group - iOS on iPhone - Portrait - Flat Design - Light Mode - Preview](https://exploreswiftui.com/api/images/131/variants/363?v=1790073478842&r=2&w=412&q=75&f=webp)

### **Disclosure Group**

A view that shows or hides another content view, based on the state of a disclosure control.

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

### **Multiple Sources Picker**

Creates a picker that updates the selected property for all sources.

![ViewThatFits Vertical - iOS on iPhone - Portrait - Flat Design - Light Mode - Preview](https://exploreswiftui.com/api/images/6/variants/20?v=1790073478842&r=2&w=412&q=75&f=webp)

### **ViewThatFits Vertical**

A view that adapts to the available vertical space by providing the first child view that fits.

![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**

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

### **Menu Section**

A Section inside a Menu

![Scroll Gesture Axis Lock - iOS on iPhone - Portrait - Liquid Glass - Light Mode - Preview](https://exploreswiftui.com/api/images/262/variants/2227?v=1794899667529&r=2&w=412&q=75&f=webp)

### **Scroll Gesture Axis Lock**

Sets whether scrollable views within this view lock each scroll gesture to its predominant axis. On macOS, scroll gestures lock to their predominant axis by default. On iOS, iPadOS, Mac Catalyst, visionOS, and watchOS, scroll gestures move along both axes at once.

![Default Collapsed Tab Section - iPadOS - Landscape - Liquid Glass - Light Mode - Preview](https://exploreswiftui.com/api/images/234/variants/341?v=1790073478842&r=2&w=412&q=75&f=webp)

### **Default Collapsed Tab Section**

Sets the default expansion state for the section containing this tab to collapsed when displayed in the sidebar.

```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/photospicker/on-primary-photos-picker-action#webpage","@type":"WebPage","dateModified":"2026-11-17T10:19:50.073Z","datePublished":"2026-11-17T09:49:12.119Z","description":"Sets the primary action handler for the Photos picker. Learn how to use On Primary Photos Picker Action in SwiftUI with visual code examples.","name":"On Primary Photos Picker Action","url":"https://exploreswiftui.com/library/photospicker/on-primary-photos-picker-action","breadcrumb":{"@id":"https://exploreswiftui.com/library/photospicker/on-primary-photos-picker-action#breadcrumb"},"isPartOf":{"@id":"https://exploreswiftui.com/#website"},"mainEntity":{"@id":"https://exploreswiftui.com/library/photospicker/on-primary-photos-picker-action#article"},"potentialAction":[{"@type":"ReadAction","target":["https://exploreswiftui.com/library/photospicker/on-primary-photos-picker-action"]}],"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/photospicker/on-primary-photos-picker-action#article","citation":"https://developer.apple.com/documentation/SwiftUI/View/photosPickerOnPrimaryAction(_:)","dateModified":"2026-11-17T10:19:50.073Z","datePublished":"2026-11-17T09:49:12.119Z","description":"Sets the primary action handler for the Photos picker. Learn how to use On Primary Photos Picker Action in SwiftUI with visual code examples.","headline":"On Primary Photos Picker Action","inLanguage":"en-US","name":"On Primary Photos Picker Action","thumbnailUrl":"https://exploreswiftui.com/api/images/267/variants/2251?v=1794910789851&r=2","url":"https://exploreswiftui.com/library/photospicker/on-primary-photos-picker-action","@type":["Article","TechArticle"],"about":{"@type":"Thing","name":"SwiftUI"},"author":{"@id":"https://exploreswiftui.com/#identity"},"hasPart":{"@id":"https://exploreswiftui.com/library/photospicker/on-primary-photos-picker-action#source-code"},"image":{"@id":"https://exploreswiftui.com/#/schema/image/1"},"isPartOf":{"@id":"https://exploreswiftui.com/library/photospicker/on-primary-photos-picker-action#webpage"},"mainEntityOfPage":{"@id":"https://exploreswiftui.com/library/photospicker/on-primary-photos-picker-action#webpage"},"publisher":{"@id":"https://exploreswiftui.com/#identity"}},{"@id":"https://exploreswiftui.com/library/photospicker/on-primary-photos-picker-action#source-code","@type":"SoftwareSourceCode","codeSampleType":"full example","description":"Sets the primary action handler for the Photos picker. Learn how to use On Primary Photos Picker Action in SwiftUI with visual code examples.","name":"On Primary Photos Picker Action SwiftUI Example","programmingLanguage":"Swift","runtimePlatform":"SwiftUI","text":"@State private var selectedPhotos: [PhotosPickerItem] = []\n\nvar body: some View {\n    PhotosPicker(\n        \"FooBar\",\n        selection: $selectedPhotos,\n        selectionRange: 2 ... 5\n    )\n    .photosPickerOnPrimaryAction {\n        print(\"selection confirmed\")\n    }\n}","about":[{"@type":"Thing","name":"SwiftUI"},{"@type":"Thing","name":"PhotosPicker"},{"@type":"Thing","name":"On Primary Photos Picker Action"}]},{"@id":"https://exploreswiftui.com/library/photospicker/on-primary-photos-picker-action#breadcrumb","@type":"BreadcrumbList","itemListElement":[{"@type":"ListItem","name":"Home","item":"https://exploreswiftui.com","position":1},{"@type":"ListItem","name":"PhotosPicker","item":"https://exploreswiftui.com/library/photospicker","position":2},{"@type":"ListItem","name":"On Primary Photos Picker Action","item":"https://exploreswiftui.com/library/photospicker/on-primary-photos-picker-action","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/267/variants/2251?v=1794910789851&r=2","inLanguage":"en","url":"https://exploreswiftui.com/api/images/267/variants/2251?v=1794910789851&r=2"}]}
```