Bulk update user profiles with LDAP directory or API

You can update user profiles with data from your organization's LDAP directory or other sources with the following methods:

Rich profile information connects users

When you add information to user profiles:

  • Individual and group addresses autocomplete in Google Workspace services like Gmail, Google Docs, and Drive.
  • Calendar intelligently suggests meeting rooms based on the location and number of guests (requires Calendar setup).
  • Users find profile information in Google Workspace services. For example, when users point to or tap someone’s profile photo, they open a person information card.

    Point to a user's profile photo to display their information card.

  • Users see organization relationships. If you add a manager email to user profiles, Directory automatically generates a reporting chain. Available in Google services on Android and iOS  and in Google Cloud Search on all devices.

What you can update

You can add, edit, or delete the following information:

You can also let users update some of their profile settings, including name, photo, and work location. Note: Gmail users can change their display name themselves.

How the Directory displays profile information

Person information card

1. Name
2. Profile photo
3. Email
4.  Phone number
5. Job title / Department
6. Desk location: Building, floor, floor section
7. Links

Contacts sidebar in Gmail

1.  Name
2. Job title / Department
3. Email
4.  Phone number
5. Desk location: Building, floor, floor section
6. Manager's email address
7. Reports: Based on reports' manager's email address

User profile fields

To set the profile information that is shared throughout Google services, edit the following fields.

Profile value Example Admin console Directory API GCDS


Sasha Lee Rename user name
  • Given name
  • Family name
Profile photo Sample user profile photo. Photo Users.photos Not available
Email address sasha.g.lee@ink-42.com Primary email primaryEmail Primary email
Phone number +1 949-555-0198 Phone


Note: Only these attributes are updated in the Admin console:

  • Home
  • Work
  • Mobile
  • Enterprise Voice
  • Work phone numbers
  • Work mobile phone numbers
  • Home phone numbers
  • Fax numbers
  • Mobile phone numbers
  • Assistant's number
Address 123 Google Way, Inktown, CA 99999 Address addresses[].formatted*
  • Street Address
  • P.O. Box
  • City
  • State/Province
  • ZIP/Postal Code
  • Country/Region
Job title Account Manager Job title organizations[].title Job title
Manager's email kat.deburgh@ink-42.com Manager's email relations[].type.manager Manager's DN
Department Marketing Department organizations[].department Department
Organization Ink 42 Change organization name organizations[].name Company name
Desk location Building B-2-151C
  • Building ID
  • Floor name
  • Floor section
locations[] with
  • Building ID
  • Floor name
Links Directory | Personal site Not available websites[] Websites

*The Directory API allows both structured address data broken out by fields and unstructured address data as represented by the addresses[].formatted field, and they are not synced to each other. If you have structured address data and update the addresses[].formatted field, we recommend also updating your structured address fields for that user.

Related topics

For other ways to update user profiles, go to:

Was this helpful?

How can we improve it?
Clear search
Close search
Google apps
Main menu