User custom fields from the directory coming to the Google Contact Manager

Today, Google Apps administrators use custom fields in the domain directory to store information like Projects, Teams, Languages, and whatever else their organization needs. Showing these fields to users within the Google Contacts user interface has been a popular feature request for many domain administrators, because having this information accessible helps users connect more easily.

In the coming weeks, the Contact Manager at will now show user custom fields from the domain directory. User custom fields will respect the permissions that the domain administrator has set.

  • If you have user custom fields which you’ve set as only visible to administrators and users, this field will only be visible in the Contact Manager to the specified administrators and users.
  •  If you have fields which are visible to anyone at the domain, then these fields will now be shown in the Contact Manager to users within the domain.
In the profile above, Profession, Active Projects, and Languages were stored in the "TeamInfo" schema.

If you’d like to start using user custom fields, the Directory API is already available in Python, Go, Java, Apps Script, PHP, and more, giving administrators flexibility over what fields to add for users. To control whether fields are shown to users or just administrators, use the readAccessType property.

If you’ve already added user custom fields, in the coming weeks, any user-visible custom fields that Google Apps administrators have added through APIs or Google Apps Directory Sync will now be visible to users as custom fields in the Contact Manager at To update the schema, use the Directory API.


  • Google Apps Sync for Microsoft Outlook users will not see custom fields in the Global Address List.

Launch Details
Release track:
Launching to both Rapid release and Scheduled release on March 31, 2016.

Rollout pace:
Full rollout (1-3 days for feature visibility).

All end users

Admin action suggested/FYI

More Information
Help Center

Note: all launches are applicable to all Google Apps editions unless otherwise noted

Launch release calendar
Launch detail categories
Get these product update alerts by email
Subscribe to the RSS feed of these updates