CNContactPicker.Show
--------------------

Shows the contact picker to select a contact.

| Component | Version | macOS | Windows | Linux | Server | iOS SDK |
|---|---|---|---|---|---|---|
| [Contacts](component_Contacts.md) | [10.1](newinversion101.md) | ✅ Yes | ❌ No | ❌ No | ❌ No | ✅ Yes |

MBS( "CNContactPicker.Show" { ; Multi or Window; Position } ) 

**MBS**( **"CNContactPicker.Show";** /\* Shows the contact picker to select a contact. \*/  
**$Multi or Window**; /\* Optional; For iOS: Whether to allow multiple selection.  
Pass 1 for multiple or 0 for single selection.   
Default is single selection.  
  
For MacOS: the window reference name/number.e.g. 0 \*/   
**$Position**) /\* Optional; Where to position the popover.  
Can be "left" for left of the FileMaker window.  
Can be "right" for right side.  
Can be "mouse" to place where mouse is, e.g. when using with button.  
Can be "toolbar" to center on window hanging from toolbar.e.g. "mouse" \*/ 

### Parameters

| Parameter | Description | Example | Flags |
|---|---|---|---|
| Multi or Window | For iOS: Whether to allow multiple selection.   Pass 1 for multiple or 0 for single selection.    Default is single selection.      For MacOS: the window reference name/number. | 0 | Optional |
| Position | Where to position the popover.   Can be "left" for left of the FileMaker window.   Can be "right" for right side.   Can be "mouse" to place where mouse is, e.g. when using with button.   Can be "toolbar" to center on window hanging from toolbar. | "mouse" | Optional |

### Result

Returns OK or error.

### Description

Shows the contact picker to select a contact.  
Use [CNContactPicker.Current](CNContactPickerCurrent.md) later to get the result.  
### Examples

Show picker:

 # use picker sheet/popover to select contact   
Set Variable \[ $r ; Value: MBS ( "[CNContactPicker.SetTrigger](CNContactPickerSetTrigger.md)"; Get(FileName); "Picked") \]   
Set Variable \[ $r ; Value: MBS ( "CNContactPicker.Show") \]   
If \[ MBS ("IsError") \]   
 Show Custom Dialog \[ "Failed to show picker" ; $r \]   
End If  
Show at mouse positon in front window:

 MBS ( "CNContactPicker.Show"; 0; "mouse")  
### See also

- [CNContactPicker.Close](CNContactPickerClose.md)
- [CNContactPicker.Current](CNContactPickerCurrent.md)
- [CNContactPicker.SetDisplayedKeys](CNContactPickerSetDisplayedKeys.md)
- [CNContactPicker.SetTrigger](CNContactPickerSetTrigger.md)
- [IsError](IsError.md)

### Release notes

- **Version 13.4**
    - Fixed an issue with [CNContactPicker.Show](https://www.mbsplugins.eu/CNContactPickerShow.shtml) raising an exception on iOS.
- **Version 10.1**
    - Added [CNContactPicker.Show](https://www.mbsplugins.eu/CNContactPickerShow.shtml) and related functions to show contact picker on MacOS and iOS.

### Example Databases

- [Mac and iOS/Contacts/Contacts Dialogs](https://www.mbsplugins.eu/MBS-FileMaker-Plugin-Examples/Mac%20and%20iOS/Contacts/Contacts%20Dialogs.shtml#4ScriptAnchor_)

### Blog Entries

- [MBS FileMaker Plugin 16.3](https://www.mbsplugins.de/archive/2026-08-04/MBS_FileMaker_Plugin_163/monkeybreadsoftware_blog_filemaker)
- [MBS FileMaker Plugin, version 13.4pr1](https://www.mbsplugins.de/archive/2023-08-01/MBS_FileMaker_Plugin_version_1/monkeybreadsoftware_blog_filemaker)
- [New in the MBS FileMaker Plugin 10.1](https://www.mbsplugins.de/archive/2020-03-17/New_in_the_MBS_FileMaker_Plugi/monkeybreadsoftware_blog_filemaker)
- [Neues MBS FileMaker Plugin 10.1 - Über 6100 Funktionen in einem Plugin](https://www.mbsplugins.de/archive/2020-03-10/Neues_MBS_FileMaker_Plugin_101/monkeybreadsoftware_blog_filemaker)
- [MBS FileMaker Plugin 10.1 - More than 6100 Functions In One Plugin](https://www.mbsplugins.de/archive/2020-03-10/MBS_FileMaker_Plugin_101_-_Mor/monkeybreadsoftware_blog_filemaker)
- [MBS FileMaker Plugin, version 10.1pr3](https://www.mbsplugins.de/archive/2020-02-10/MBS_FileMaker_Plugin_version_1/monkeybreadsoftware_blog_filemaker)
- [MBS FileMaker Plugin, version 10.1pr2](https://www.mbsplugins.de/archive/2020-02-03/MBS_FileMaker_Plugin_version_1/monkeybreadsoftware_blog_filemaker)
- [Contact picker and viewer for FileMaker](https://www.mbsplugins.de/archive/2020-01-31/Contact_picker_and_viewer_for_/monkeybreadsoftware_blog_filemaker)

This function checks for a license.

Created 31st January 2020 , last changed 4th February 2020

  
[CNContactPicker.SetTrigger](CNContactPickerSetTrigger.md) - [CNContactStore.AddContact](CNContactStoreAddContact.md)

[HTML Version](CNContactPickerShow.shtml)