Supported contact keys

The information about a contact is represented as keys. Each key corresponds to a specific piece of information, such as first name, last name, home phone number, or email address. Each contact has at least one key. The supported set of keys depends on the contacts database. If you try to add a key to a database that does not support it, the Add method returns an error message.

The following table lists the combined set of keys supported by databases compatible with S60 5th Edition:

The default device database (URI: cntdb://c:contacts.cdb) supports all the listed keys.
The SIM card database (URI: sim://global_adn) supports a subset of the listed keys. The supported keys are indicated in the Supported by SIM column.

In JavaScript, keys are represented as objects, with the key name as the object name. For example, the ReturnValue iterator returned by a GetList call might contain the following keys (objects) for the first contact item:

ReturnValue[0].FirstName
ReturnValue[0].LastName
ReturnValue[0].LandPhoneHome
ReturnValue[0].EmailHome

Note: The SyncClass key is added to a contact by default, with the Label property set to "Synchronisation" and the Value property to "private", unless specified as "public". Values other than "private" or "public" are stored as "private".

**Table:** Contact keys
Key	Description	Maximum length	Supported by SIM
`LastName`	Last name	50 (14 for SIM)	X
`FirstName`	First name	50
`Prefix`	Name prefix	10
`Suffix`	Name suffix	10
`SecondName`	Second name	50
`LandPhoneHome`	Home land phone number	48
`MobilePhoneHome`	Home mobile phone number	48
`VideoNumberHome`	Home video number	48
`FaxNumberHome`	Home fax number	48
`VoipHome`	Home VoIP phone number	100
`EmailHome`	Home email address	150
`URLHome`	Home URL	1000
`AddrLabelHome`	Home address label	250
`AddrPOHome`	Home address post office	20
`AddrEXTHome`	Home address extension	50
`AddrStreetHome`	Home address street	50
`AddrLocalHome`	Home address local	50
`AddrRegionHome`	Home address region	50
`AddrPostCodeHome`	Home address postal code	20
`AddrCountryHome`	Home address country	50
`JobTitle`	Job title	50
`CompanyName`	Company name	50
`LandPhoneWork`	Work land phone number	48
`MobilePhoneWork`	Work mobile phone number	48
`VideoNumberWork`	Work video number	48
`FaxNumberWork`	Work fax number	48
`VoipWork`	Work VoIP phone number	100
`EmailWork`	Work email address	150
`URLWork`	Work URL	1000
`AddrLabelWork`	Work address label	250
`AddrPOWork`	Work address post office	20
`AddrEXTWork`	Work address extension	50
`AddrStreetWork`	Work address street	50
`AddrLocalWork`	Work address local	50
`AddrRegionWork`	Work address region	50
`AddrPostCodeWork`	Work address postal code	20
`AddrCountryWork`	Work address country	50
`LandPhoneGen`	General land phone number	48
`MobilePhoneGen`	General mobile phone number	48	X
`VideoNumberGen`	General video number	48
`FaxNumberGen`	General fax number	48
`VOIPGen`	General VoIP phone number	100
`POC`	Push to Talk over Cellular (PoC)	100
`SWIS`	"See What I See" (SWIS)	100
`SIP`	SIP identity	100
`EmailGen`	General email address	150
`URLGen`	General URL	1000
`AddrLabelGen`	General address label	250
`AddrPOGen`	General address post office	20
`AddrExtGen`	General address extension	50
`AddrStreetGen`	General address street	50
`AddrLocalGen`	General address local	50
`AddrRegionGen`	General address region	50
`AddrPostCodeGen`	General address postal code	20
`AddrCountryGen`	General address country	50
`PageNumber`	Pager number	48
`DTMFString`	DTMF string	60
`Date`	Date	This key is in TTime format.
`Note`	Note	1000
`Ringtone`	Ring tone	256
`MiddleName`	Middle name	50
`Department`	Department name	50
`AsstName`	Assistant name	50
`Spouse`	Spouse name	50
`Children`	Children	50
`AsstPhone`	Assistant phone number	50
`CarPhone`	Car phone number	48
`Anniversary`	Anniversary	This key is in TTime format.
`SyncClass`	Synchronisation Possible values: `"Public"` `"Private"` Any other value is interpreted as `"Private"`.	1000
`LOCPrivacy`	Locality privacy	256