# ContactsContract.ContactsColumns

Added in[API level 5](https://developer.android.com/guide/topics/manifest/uses-sdk-element#ApiLevels)  
Summary:[Constants](https://developer.android.com/reference/android/provider/ContactsContract.ContactsColumns#constants)  

# ContactsContract.ContactsColumns

*** ** * ** ***

[Kotlin](https://developer.android.com/reference/kotlin/android/provider/ContactsContract.ContactsColumns "View this page in Kotlin")\|Java

`
protected
static


interface
ContactsContract.ContactsColumns
`  
`


`

|---------------------------------------------------|
| android.provider.ContactsContract.ContactsColumns |

|-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|
| Known indirect subclasses [ContactsContract.CommonDataKinds.Callable](https://developer.android.com/reference/android/provider/ContactsContract.CommonDataKinds.Callable),[ContactsContract.CommonDataKinds.Contactables](https://developer.android.com/reference/android/provider/ContactsContract.CommonDataKinds.Contactables),[ContactsContract.CommonDataKinds.Email](https://developer.android.com/reference/android/provider/ContactsContract.CommonDataKinds.Email),[ContactsContract.CommonDataKinds.Event](https://developer.android.com/reference/android/provider/ContactsContract.CommonDataKinds.Event),[ContactsContract.CommonDataKinds.GroupMembership](https://developer.android.com/reference/android/provider/ContactsContract.CommonDataKinds.GroupMembership),[ContactsContract.CommonDataKinds.Identity](https://developer.android.com/reference/android/provider/ContactsContract.CommonDataKinds.Identity),[ContactsContract.CommonDataKinds.Im](https://developer.android.com/reference/android/provider/ContactsContract.CommonDataKinds.Im),[ContactsContract.CommonDataKinds.Nickname](https://developer.android.com/reference/android/provider/ContactsContract.CommonDataKinds.Nickname),[ContactsContract.CommonDataKinds.Note](https://developer.android.com/reference/android/provider/ContactsContract.CommonDataKinds.Note),[ContactsContract.CommonDataKinds.Organization](https://developer.android.com/reference/android/provider/ContactsContract.CommonDataKinds.Organization),[ContactsContract.CommonDataKinds.Phone](https://developer.android.com/reference/android/provider/ContactsContract.CommonDataKinds.Phone),[ContactsContract.CommonDataKinds.Photo](https://developer.android.com/reference/android/provider/ContactsContract.CommonDataKinds.Photo),[ContactsContract.CommonDataKinds.Relation](https://developer.android.com/reference/android/provider/ContactsContract.CommonDataKinds.Relation),[ContactsContract.CommonDataKinds.SipAddress](https://developer.android.com/reference/android/provider/ContactsContract.CommonDataKinds.SipAddress),[ContactsContract.CommonDataKinds.StructuredName](https://developer.android.com/reference/android/provider/ContactsContract.CommonDataKinds.StructuredName), and 10 others. |-----------------------------------------------------------------------------------------------------------------------------------------------------------------|-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------| | [ContactsContract.CommonDataKinds.Callable](https://developer.android.com/reference/android/provider/ContactsContract.CommonDataKinds.Callable)                 | Convenient functionalities for "callable" data.                                                                                                                                                                                                                                                                                                       | | [ContactsContract.CommonDataKinds.Contactables](https://developer.android.com/reference/android/provider/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](https://developer.android.com/reference/android/provider/ContactsContract.CommonDataKinds.Phone)and[Email](https://developer.android.com/reference/android/provider/ContactsContract.CommonDataKinds.Email)). | | [ContactsContract.CommonDataKinds.Email](https://developer.android.com/reference/android/provider/ContactsContract.CommonDataKinds.Email)                       | A data kind representing an email address.                                                                                                                                                                                                                                                                                                            | | [ContactsContract.CommonDataKinds.Event](https://developer.android.com/reference/android/provider/ContactsContract.CommonDataKinds.Event)                       | A data kind representing an event.                                                                                                                                                                                                                                                                                                                    | | [ContactsContract.CommonDataKinds.GroupMembership](https://developer.android.com/reference/android/provider/ContactsContract.CommonDataKinds.GroupMembership)   | Group Membership.                                                                                                                                                                                                                                                                                                                                     | | [ContactsContract.CommonDataKinds.Identity](https://developer.android.com/reference/android/provider/ContactsContract.CommonDataKinds.Identity)                 | A data kind representing an Identity related to the contact.                                                                                                                                                                                                                                                                                          | | [ContactsContract.CommonDataKinds.Im](https://developer.android.com/reference/android/provider/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](https://developer.android.com/reference/android/provider/ContactsContract.CommonDataKinds.Nickname)                 | A data kind representing the contact's nickname.                                                                                                                                                                                                                                                                                                      | | [ContactsContract.CommonDataKinds.Note](https://developer.android.com/reference/android/provider/ContactsContract.CommonDataKinds.Note)                         | Notes about the contact.                                                                                                                                                                                                                                                                                                                              | | [ContactsContract.CommonDataKinds.Organization](https://developer.android.com/reference/android/provider/ContactsContract.CommonDataKinds.Organization)         | A data kind representing an organization.                                                                                                                                                                                                                                                                                                             | | [ContactsContract.CommonDataKinds.Phone](https://developer.android.com/reference/android/provider/ContactsContract.CommonDataKinds.Phone)                       | A data kind representing a telephone number.                                                                                                                                                                                                                                                                                                          | | [ContactsContract.CommonDataKinds.Photo](https://developer.android.com/reference/android/provider/ContactsContract.CommonDataKinds.Photo)                       | A data kind representing a photo for the contact.                                                                                                                                                                                                                                                                                                     | | [ContactsContract.CommonDataKinds.Relation](https://developer.android.com/reference/android/provider/ContactsContract.CommonDataKinds.Relation)                 | A data kind representing a relation.                                                                                                                                                                                                                                                                                                                  | | [ContactsContract.CommonDataKinds.SipAddress](https://developer.android.com/reference/android/provider/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](https://developer.android.com/reference/android/provider/ContactsContract.CommonDataKinds.StructuredName)     | A data kind representing the contact's proper name.                                                                                                                                                                                                                                                                                                   | | [ContactsContract.CommonDataKinds.StructuredPostal](https://developer.android.com/reference/android/provider/ContactsContract.CommonDataKinds.StructuredPostal) | A data kind representing a postal addresses.                                                                                                                                                                                                                                                                                                          | | [ContactsContract.CommonDataKinds.Website](https://developer.android.com/reference/android/provider/ContactsContract.CommonDataKinds.Website)                   | A data kind representing a website related to the contact.                                                                                                                                                                                                                                                                                            | | [ContactsContract.Contacts](https://developer.android.com/reference/android/provider/ContactsContract.Contacts)                                                 | Constants for the contacts table, which contains a record per aggregate of raw contacts representing the same person.                                                                                                                                                                                                                                 | | [ContactsContract.Contacts.AggregationSuggestions](https://developer.android.com/reference/android/provider/ContactsContract.Contacts.AggregationSuggestions)   | A*read-only*sub-directory of a single contact aggregate that contains all aggregation suggestions (other contacts).                                                                                                                                                                                                                                   | | [ContactsContract.Contacts.Entity](https://developer.android.com/reference/android/provider/ContactsContract.Contacts.Entity)                                   | A sub-directory of a contact that contains all of its[ContactsContract.RawContacts](https://developer.android.com/reference/android/provider/ContactsContract.RawContacts)as well as[ContactsContract.Data](https://developer.android.com/reference/android/provider/ContactsContract.Data)rows.                                                      | | [ContactsContract.Contacts.Photo](https://developer.android.com/reference/android/provider/ContactsContract.Contacts.Photo)                                     | A*read-only*sub-directory of a single contact that contains the contact's primary photo.                                                                                                                                                                                                                                                              | | [ContactsContract.Data](https://developer.android.com/reference/android/provider/ContactsContract.Data)                                                         | Constants for the data table, which contains data points tied to a raw contact.                                                                                                                                                                                                                                                                       | | [ContactsContract.DataColumnsWithJoins](https://developer.android.com/reference/android/provider/ContactsContract.DataColumnsWithJoins)                         | Combines all columns returned by[ContactsContract.Data](https://developer.android.com/reference/android/provider/ContactsContract.Data)table queries.                                                                                                                                                                                                 | | [ContactsContract.PhoneLookup](https://developer.android.com/reference/android/provider/ContactsContract.PhoneLookup)                                           | A table that represents the result of looking up a phone number, for example for caller ID.                                                                                                                                                                                                                                                           | | [ContactsContract.Profile](https://developer.android.com/reference/android/provider/ContactsContract.Profile)                                                   | Constants for the user's profile data, which is represented as a single contact on the device that represents the user.                                                                                                                                                                                                                               | |

<br />

*** ** * ** ***

Columns of[ContactsContract.Contacts](https://developer.android.com/reference/android/provider/ContactsContract.Contacts)that refer to intrinsic properties of the contact, as opposed to the user-specified options found in[ContactOptionsColumns](https://developer.android.com/reference/android/provider/ContactsContract.ContactOptionsColumns).  
**See also:**

- [ContactsContract.Contacts](https://developer.android.com/reference/android/provider/ContactsContract.Contacts)
- [ContactsContract.Data](https://developer.android.com/reference/android/provider/ContactsContract.Data)
- [ContactsContract.PhoneLookup](https://developer.android.com/reference/android/provider/ContactsContract.PhoneLookup)
- [ContactsContract.Contacts.AggregationSuggestions](https://developer.android.com/reference/android/provider/ContactsContract.Contacts.AggregationSuggestions)

## Summary

|                                                                                                                                                                                                                                                          ### Constants                                                                                                                                                                                                                                                          ||
|--------------------------------------------------------------------|-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|
| [String](https://developer.android.com/reference/java/lang/String) | [CONTACT_LAST_UPDATED_TIMESTAMP](https://developer.android.com/reference/android/provider/ContactsContract.ContactsColumns#CONTACT_LAST_UPDATED_TIMESTAMP) Timestamp (milliseconds since epoch) of when this contact was last updated.                                                                                                                                                                                                                      |
| [String](https://developer.android.com/reference/java/lang/String) | [DISPLAY_NAME](https://developer.android.com/reference/android/provider/ContactsContract.ContactsColumns#DISPLAY_NAME) The display name for the contact.                                                                                                                                                                                                                                                                                                    |
| [String](https://developer.android.com/reference/java/lang/String) | [HAS_PHONE_NUMBER](https://developer.android.com/reference/android/provider/ContactsContract.ContactsColumns#HAS_PHONE_NUMBER) An indicator of whether this contact has at least one phone number.                                                                                                                                                                                                                                                          |
| [String](https://developer.android.com/reference/java/lang/String) | [IN_DEFAULT_DIRECTORY](https://developer.android.com/reference/android/provider/ContactsContract.ContactsColumns#IN_DEFAULT_DIRECTORY) Flag that reflects whether the contact exists inside the default directory.                                                                                                                                                                                                                                          |
| [String](https://developer.android.com/reference/java/lang/String) | [IN_VISIBLE_GROUP](https://developer.android.com/reference/android/provider/ContactsContract.ContactsColumns#IN_VISIBLE_GROUP) Flag that reflects the[Groups.GROUP_VISIBLE](https://developer.android.com/reference/android/provider/ContactsContract.GroupsColumns#GROUP_VISIBLE)state of any[CommonDataKinds.GroupMembership](https://developer.android.com/reference/android/provider/ContactsContract.CommonDataKinds.GroupMembership)for this contact. |
| [String](https://developer.android.com/reference/java/lang/String) | [IS_USER_PROFILE](https://developer.android.com/reference/android/provider/ContactsContract.ContactsColumns#IS_USER_PROFILE) Flag that reflects whether this contact represents the user's personal profile entry.                                                                                                                                                                                                                                          |
| [String](https://developer.android.com/reference/java/lang/String) | [LOOKUP_KEY](https://developer.android.com/reference/android/provider/ContactsContract.ContactsColumns#LOOKUP_KEY) An opaque value that contains hints on how to find the contact if its row id changed as a result of a sync or aggregation.                                                                                                                                                                                                               |
| [String](https://developer.android.com/reference/java/lang/String) | [NAME_RAW_CONTACT_ID](https://developer.android.com/reference/android/provider/ContactsContract.ContactsColumns#NAME_RAW_CONTACT_ID) Reference to the row in the RawContacts table holding the contact name.                                                                                                                                                                                                                                                |
| [String](https://developer.android.com/reference/java/lang/String) | [PHOTO_FILE_ID](https://developer.android.com/reference/android/provider/ContactsContract.ContactsColumns#PHOTO_FILE_ID) Photo file ID of the full-size photo.                                                                                                                                                                                                                                                                                              |
| [String](https://developer.android.com/reference/java/lang/String) | [PHOTO_ID](https://developer.android.com/reference/android/provider/ContactsContract.ContactsColumns#PHOTO_ID) Reference to the row in the data table holding the photo.                                                                                                                                                                                                                                                                                    |
| [String](https://developer.android.com/reference/java/lang/String) | [PHOTO_THUMBNAIL_URI](https://developer.android.com/reference/android/provider/ContactsContract.ContactsColumns#PHOTO_THUMBNAIL_URI) A URI that can be used to retrieve a thumbnail of the contact's photo.                                                                                                                                                                                                                                                 |
| [String](https://developer.android.com/reference/java/lang/String) | [PHOTO_URI](https://developer.android.com/reference/android/provider/ContactsContract.ContactsColumns#PHOTO_URI) A URI that can be used to retrieve the contact's full-size photo.                                                                                                                                                                                                                                                                          |

## Constants

### CONTACT_LAST_UPDATED_TIMESTAMP

Added in[API level 18](https://developer.android.com/guide/topics/manifest/uses-sdk-element#ApiLevels)  

```
public static final String CONTACT_LAST_UPDATED_TIMESTAMP
```

Timestamp (milliseconds since epoch) of when this contact was last updated. This includes updates to all data associated with this contact including raw contacts. Any modification (including deletes and inserts) of underlying contact data are also reflected in this timestamp.

<br />

Constant Value: "contact_last_updated_timestamp"  

### DISPLAY_NAME

Added in[API level 5](https://developer.android.com/guide/topics/manifest/uses-sdk-element#ApiLevels)  

```
public static final String DISPLAY_NAME
```

The display name for the contact.

Type: TEXT

<br />

<br />

Constant Value: "display_name"  

### HAS_PHONE_NUMBER

Added in[API level 5](https://developer.android.com/guide/topics/manifest/uses-sdk-element#ApiLevels)  

```
public static final String HAS_PHONE_NUMBER
```

An indicator of whether this contact has at least one phone number. "1" if there is at least one phone number, "0" otherwise.

Type: INTEGER

<br />

<br />

Constant Value: "has_phone_number"  

### IN_DEFAULT_DIRECTORY

Added in[API level 21](https://developer.android.com/guide/topics/manifest/uses-sdk-element#ApiLevels)  

```
public static final String IN_DEFAULT_DIRECTORY
```

Flag that reflects whether the contact exists inside the default directory. Ie, whether the contact is designed to only be visible outside search.

<br />

Constant Value: "in_default_directory"  

### IN_VISIBLE_GROUP

Added in[API level 5](https://developer.android.com/guide/topics/manifest/uses-sdk-element#ApiLevels)  

```
public static final String IN_VISIBLE_GROUP
```

Flag that reflects the[Groups.GROUP_VISIBLE](https://developer.android.com/reference/android/provider/ContactsContract.GroupsColumns#GROUP_VISIBLE)state of any[CommonDataKinds.GroupMembership](https://developer.android.com/reference/android/provider/ContactsContract.CommonDataKinds.GroupMembership)for this contact.

<br />

Constant Value: "in_visible_group"  

### IS_USER_PROFILE

Added in[API level 14](https://developer.android.com/guide/topics/manifest/uses-sdk-element#ApiLevels)  

```
public static final String IS_USER_PROFILE
```

Flag that reflects whether this contact represents the user's personal profile entry.

<br />

Constant Value: "is_user_profile"  

### LOOKUP_KEY

Added in[API level 5](https://developer.android.com/guide/topics/manifest/uses-sdk-element#ApiLevels)  

```
public static final String LOOKUP_KEY
```

An opaque value that contains hints on how to find the contact if its row id changed as a result of a sync or aggregation.

<br />

Constant Value: "lookup"  

### NAME_RAW_CONTACT_ID

Added in[API level 21](https://developer.android.com/guide/topics/manifest/uses-sdk-element#ApiLevels)  

```
public static final String NAME_RAW_CONTACT_ID
```

Reference to the row in the RawContacts table holding the contact name.

Type: INTEGER REFERENCES raw_contacts(_id)

<br />

<br />

Constant Value: "name_raw_contact_id"  

### PHOTO_FILE_ID

Added in[API level 14](https://developer.android.com/guide/topics/manifest/uses-sdk-element#ApiLevels)  

```
public static final String PHOTO_FILE_ID
```

Photo file ID of the full-size photo. If present, this will be used to populate[PHOTO_URI](https://developer.android.com/reference/android/provider/ContactsContract.ContactsColumns#PHOTO_URI). The ID can also be used with[ContactsContract.DisplayPhoto.CONTENT_URI](https://developer.android.com/reference/android/provider/ContactsContract.DisplayPhoto#CONTENT_URI)to create a URI to the photo. If this is present,[PHOTO_ID](https://developer.android.com/reference/android/provider/ContactsContract.ContactsColumns#PHOTO_ID)is also guaranteed to be populated.

Type: INTEGER

<br />

<br />

Constant Value: "photo_file_id"  

### PHOTO_ID

Added in[API level 5](https://developer.android.com/guide/topics/manifest/uses-sdk-element#ApiLevels)  

```
public static final String PHOTO_ID
```

Reference to the row in the data table holding the photo. A photo can be referred to either by ID (this field) or by URI (see[PHOTO_THUMBNAIL_URI](https://developer.android.com/reference/android/provider/ContactsContract.ContactsColumns#PHOTO_THUMBNAIL_URI)and[PHOTO_URI](https://developer.android.com/reference/android/provider/ContactsContract.ContactsColumns#PHOTO_URI)). If PHOTO_ID is null, consult[PHOTO_URI](https://developer.android.com/reference/android/provider/ContactsContract.ContactsColumns#PHOTO_URI)or[PHOTO_THUMBNAIL_URI](https://developer.android.com/reference/android/provider/ContactsContract.ContactsColumns#PHOTO_THUMBNAIL_URI), which is a more generic mechanism for referencing the contact photo, especially for contacts returned by non-local directories (see[Directory](https://developer.android.com/reference/android/provider/ContactsContract.Directory)).

Type: INTEGER REFERENCES data(_id)

<br />

<br />

Constant Value: "photo_id"  

### PHOTO_THUMBNAIL_URI

Added in[API level 11](https://developer.android.com/guide/topics/manifest/uses-sdk-element#ApiLevels)  

```
public static final String PHOTO_THUMBNAIL_URI
```

A URI that can be used to retrieve a thumbnail of the contact's photo. A photo can be referred to either by a URI (this field or[PHOTO_URI](https://developer.android.com/reference/android/provider/ContactsContract.ContactsColumns#PHOTO_URI)) or by ID (see[PHOTO_ID](https://developer.android.com/reference/android/provider/ContactsContract.ContactsColumns#PHOTO_ID)). If PHOTO_ID is not null, PHOTO_URI and PHOTO_THUMBNAIL_URI shall not be null (but not necessarily vice versa). If the content provider does not differentiate between full-size photos and thumbnail photos, PHOTO_THUMBNAIL_URI and[PHOTO_URI](https://developer.android.com/reference/android/provider/ContactsContract.ContactsColumns#PHOTO_URI)can contain the same value, but either both shall be null or both not null.

Type: TEXT

<br />

<br />

Constant Value: "photo_thumb_uri"  

### PHOTO_URI

Added in[API level 11](https://developer.android.com/guide/topics/manifest/uses-sdk-element#ApiLevels)  

```
public static final String PHOTO_URI
```

A URI that can be used to retrieve the contact's full-size photo. If PHOTO_FILE_ID is not null, this will be populated with a URI based off[ContactsContract.DisplayPhoto.CONTENT_URI](https://developer.android.com/reference/android/provider/ContactsContract.DisplayPhoto#CONTENT_URI). Otherwise, this will be populated with the same value as[PHOTO_THUMBNAIL_URI](https://developer.android.com/reference/android/provider/ContactsContract.ContactsColumns#PHOTO_THUMBNAIL_URI). A photo can be referred to either by a URI (this field) or by ID (see[PHOTO_ID](https://developer.android.com/reference/android/provider/ContactsContract.ContactsColumns#PHOTO_ID)). If either PHOTO_FILE_ID or PHOTO_ID is not null, PHOTO_URI and PHOTO_THUMBNAIL_URI shall not be null (but not necessarily vice versa). Thus using PHOTO_URI is a more robust method of retrieving contact photos.

Type: TEXT

<br />

<br />

Constant Value: "photo_uri"