Components All New MacOS Windows Linux iOS
Examples Mac & Win Server Client Guides Statistic FMM Blog Deprecated Old


Shows the contact picker to select a contact.

Component Version macOS Windows Linux Server iOS SDK
Contacts 10.1 ✅ Yes ❌ No ❌ No ❌ No ✅ Yes
MBS( "CNContactPicker.Show" { ; Multi or Window; Position } )   More


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


Returns OK or error.


Shows the contact picker to select a contact.
Use CNContactPicker.Current later to get the result.


Show picker:

# use picker sheet/popover to select contact
Set Variable [ $r ; Value: MBS( "CNContactPicker.SetTrigger"; 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

Release notes

Example Databases

Blog Entries

This function checks for a license.

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

CNContactPicker.SetTrigger - CNContactStore.AddContact