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

CNContactPicker.CurrentProperties

Queries the properties selected in the picker.

Component Version macOS Windows Linux Server iOS SDK
Contacts 16.3 ✅ Yes ❌ No ❌ No ❌ No ✅ Yes
MBS( "CNContactPicker.CurrentProperties" )

Parameters

none

Result

Returns JSON or error.

Description

Queries the properties selected in the picker.
Returns a JSON array with an entry for each selected property item.
The entries include a contactIdentifier, labelIdentifier, label, value and a key.

Examples

Query selected phone property:

Set Variable [ $json; Value: MBS( "CNContactPicker.CurrentProperties" ) ]

Example result:
[ { "labelIdentifier" : "CBAA080F-9D3B-4238-B1C4-2190757AB085", "value" : "0160990123456", "key" : "phoneNumbers", "contactIdentifier" : "0D4A63D7-240A-46EB-A0F3-9E8EAFB37C60:ABPerson", "label" : "_$!<Mobile>!$_" } ]

Query selected email property:

Set Variable [ $json; Value: MBS( "CNContactPicker.CurrentProperties" ) ]

Example result:
[ { "labelIdentifier" : "07B55F44-F710-4AC4-B5A8-25AB7322F2EC", "value" : "test@monkeybreadsoftware.de", "key" : "emailAddresses", "contactIdentifier" : "4073C419-3AEF-40A6-9F0A-B0CCA3943F90:ABPerson", "label" : "_$!<Work>!$_" } ]

Query selected social profile property:

Set Variable [ $json; Value: MBS( "CNContactPicker.CurrentProperties" ) ]

Example result:
[ { "labelIdentifier" : "E4E32526-3B79-47FE-8D66-F5CE197A9C0E", "value" : { "username" : "MonkeybreadSoftware", "userIdentifier" : null, "service" : "Facebook", "urlString" : "http:\/\/facebook.com\/MonkeybreadSoftware" }, "key" : "socialProfiles", "contactIdentifier" : "4073C419-3AEF-40A6-9F0A-B0CCA3943F90:ABPerson", "label" : "" } ]

Query selected postal address property:

Set Variable [ $json; Value: MBS( "CNContactPicker.CurrentProperties" ) ]

Example result:
[ { "labelIdentifier" : "84F16DFF-612C-42AF-8EDD-C697084B0B69", "value" : { "street" : "Teststr. 10", "subLocality" : "", "city" : "Nickenich", "postalCode" : "56645", "country" : "Deutschland", "subAdministrativeArea" : "", "state" : "", "ISOCountryCode" : "de" }, "key" : "postalAddresses", "contactIdentifier" : "FCDDC552-ECC8-480F-B048-0702DB9A1469:ABPerson", "label" : "_$!<Work>!$_" } ]

Query selected instant message address property:

Set Variable [ $json; Value: MBS( "CNContactPicker.CurrentProperties" ) ]

Example result:
[ { "labelIdentifier" : "A1AB0916-27ED-46E8-8C2A-2AE95ED262B1", "value" : { "service" : "SkypeInstant", "username" : "test123" }, "key" : "instantMessageAddresses", "contactIdentifier" : "44095079-388D-4361-A485-205DBE800832:ABPerson", "label" : "_$!<Work>!$_" } ]

See also

Release notes

  • Version 16.3
    • Added CNContactPicker.CurrentProperties function.

This function is free to use.

Created 14th May 2026, last changed 18th May 2026


CNContactPicker.Current - CNContactPicker.GetDisplayedKeys