Added in API level 5

Summary: Constants

ContactsContract.ContactOptionsColumns

Kotlin |Java

protected static interface ContactsContract.ContactOptionsColumns

android.provider.ContactsContract.ContactOptionsColumns

Known indirect subclasses

ContactsContract.CommonDataKinds.Callable	Convenient functionalities for "callable" data.
ContactsContract.CommonDataKinds.Contactables	A special class of data items, used to refer to types of data that can be used to attempt to start communicating with a person (`Phone` and `Email`).
ContactsContract.CommonDataKinds.Email	A data kind representing an email address.
ContactsContract.CommonDataKinds.Event	A data kind representing an event.
ContactsContract.CommonDataKinds.GroupMembership	Group Membership.
ContactsContract.CommonDataKinds.Identity	A data kind representing an Identity related to the contact.
ContactsContract.CommonDataKinds.Im	This class was deprecated in API level 35. This field may not be well supported by some contacts apps and is discouraged to use.
ContactsContract.CommonDataKinds.Nickname	A data kind representing the contact's nickname.
ContactsContract.CommonDataKinds.Note	Notes about the contact.
ContactsContract.CommonDataKinds.Organization	A data kind representing an organization.
ContactsContract.CommonDataKinds.Phone	A data kind representing a telephone number.
ContactsContract.CommonDataKinds.Photo	A data kind representing a photo for the contact.
ContactsContract.CommonDataKinds.Relation	A data kind representing a relation.
ContactsContract.CommonDataKinds.SipAddress	This class was deprecated in API level 35. This field may not be well supported by some contacts apps and is discouraged to use.
ContactsContract.CommonDataKinds.StructuredName	A data kind representing the contact's proper name.
ContactsContract.CommonDataKinds.StructuredPostal	A data kind representing a postal addresses.
ContactsContract.CommonDataKinds.Website	A data kind representing a website related to the contact.
ContactsContract.Contacts	Constants for the contacts table, which contains a record per aggregate of raw contacts representing the same person.
ContactsContract.Contacts.AggregationSuggestions	A read-only sub-directory of a single contact aggregate that contains all aggregation suggestions (other contacts).
ContactsContract.Contacts.Entity	A sub-directory of a contact that contains all of its `ContactsContract.RawContacts` as well as `ContactsContract.Data` rows.
ContactsContract.Contacts.Photo	A read-only sub-directory of a single contact that contains the contact's primary photo.
ContactsContract.Data	Constants for the data table, which contains data points tied to a raw contact.
ContactsContract.DataColumnsWithJoins	Combines all columns returned by `ContactsContract.Data` table queries.
ContactsContract.PhoneLookup	A table that represents the result of looking up a phone number, for example for caller ID.
ContactsContract.Profile	Constants for the user's profile data, which is represented as a single contact on the device that represents the user.
ContactsContract.RawContacts	Constants for the raw contacts table, which contains one row of contact information for each person in each synced account.

Columns of ContactsContract.Contacts that track the user's preferences for, or interactions with, the contact.

See also:

Summary

Constants
`String`	`CUSTOM_RINGTONE` URI for a custom ringtone associated with the contact.
`String`	`LAST_TIME_CONTACTED` This constant was deprecated in API level 29. Contacts affinity information is no longer supported as of Android version `Build.VERSION_CODES.Q`. This column always contains 0.
`String`	`PINNED` The position at which the contact is pinned.
`String`	`SEND_TO_VOICEMAIL` Whether the contact should always be sent to voicemail.
`String`	`STARRED` Is the contact starred? Type: INTEGER (boolean)
`String`	`TIMES_CONTACTED` This constant was deprecated in API level 29. Contacts affinity information is no longer supported as of Android version `Build.VERSION_CODES.Q`. This column always contains 0.

Constants

CUSTOM_RINGTONE

Added in API level 5

public static final String CUSTOM_RINGTONE

URI for a custom ringtone associated with the contact. If null or missing, the default ringtone is used.

Type: TEXT (URI to the ringtone)

Constant Value: "custom_ringtone"

LAST_TIME_CONTACTED

Added in API level 5
Deprecated in API level 29

public static final String LAST_TIME_CONTACTED

This constant was deprecated in API level 29.
Contacts affinity information is no longer supported as of Android version Build.VERSION_CODES.Q. This column always contains 0.

The last time a contact was contacted.

Caution: If you publish your app to the Google Play Store, this field is obsolete, regardless of Android version. For more information, see the Contacts Provider page.

Type: INTEGER

Constant Value: "last_time_contacted"

PINNED

Added in API level 21

public static final String PINNED

The position at which the contact is pinned. If PinnedPositions.UNPINNED, the contact is not pinned. Also see PinnedPositions.

Type: INTEGER

Constant Value: "pinned"

SEND_TO_VOICEMAIL

Added in API level 5

public static final String SEND_TO_VOICEMAIL

Whether the contact should always be sent to voicemail. If missing, defaults to false.

Type: INTEGER (0 for false, 1 for true)

Constant Value: "send_to_voicemail"

STARRED

Added in API level 5

public static final String STARRED

Is the contact starred?

Type: INTEGER (boolean)

Constant Value: "starred"

TIMES_CONTACTED

Added in API level 5
Deprecated in API level 29

public static final String TIMES_CONTACTED

This constant was deprecated in API level 29.
Contacts affinity information is no longer supported as of Android version Build.VERSION_CODES.Q. This column always contains 0.

The number of times a contact has been contacted.

Caution: If you publish your app to the Google Play Store, this field is obsolete, regardless of Android version. For more information, see the Contacts Provider page.

Type: INTEGER

Constant Value: "times_contacted"

Content and code samples on this page are subject to the licenses described in the Content License. Java and OpenJDK are trademarks or registered trademarks of Oracle and/or its affiliates.

ContactsContract.ContactOptionsColumns

Summary

Constants

Constants

CUSTOM_RINGTONE

LAST_TIME_CONTACTED

PINNED

SEND_TO_VOICEMAIL

STARRED

TIMES_CONTACTED

More Android

Discover

Android Devices

Releases

Documentation and Downloads

Support