Manage custom user attributes

If you have the legacy free edition of G Suite, upgrade to G Suite Basic to get this feature. 

You can store organization-specific information about your users, such as location or employee start date, in addition to the standard information, such as employee ID and title, in a user's profile. To store this additional information, you create custom attributes. 

When you create a custom attribute, you can specify whether the information is visible to all users in your organization or just to administrators and the individual user.

Warning: Don't use this feature to store sensitive personally identifiable information (PII), such as account credentials, government ID numbers, cardholder data, financial account data, healthcare information, or sensitive background information.

Add, edit, or delete custom attributes

Add a new custom attribute
To organize custom attributes, you create attribute categories. For example, say you want to capture information about your sales team’s fleet of cars. You would create categories, such as "registration" or "insurance," in which to record attribute values—that is, text, number, or date values.
  1. Sign in to your Google Admin console.

    Sign in using your administrator account (does not end in @gmail.com).

  2. From the Admin console Home page, go to Users.
  3. At the top of Users list, click Manage user attributes User attributes.
  4. Under Standard attributes, review the standard attributes in a user's profile.
  5. At the top right, click Add Custom Attribute.
  6. Under Category, enter a name for the category you want to add.
  7. (Optional) Under Description, enter a description of your category.
  8. Under Custom fields, create a custom attribute:
    1. Name—Enter the label you want to display on the user’s account page.
    2. Info type—Select Text, Whole number, Yes or no, Decimal number, Phone, Email, or Date.

      Note: You can't edit the info type once you've created your custom attribute.

    3. Visibility:
      • Visible to admin—Only administrators and the individual user can see the custom attribute.
      • Visible to domain—All users in the organization can see the custom attribute in each others' profiles.
    4. Number of values—Select Multi-value or Single value.

      Note: You can't change Multi-value to Single value once you've created your custom attribute.

  9. (Optional) Add another attribute.

    Note: You can define a maximum of 100 attributes over all apps. Because each app has one default attribute, the total amount includes the default attribute plus any custom attributes you add. For example, if you have 25 apps you can't add more than 3 attributes to each. Once you add 3 custom attributes to each you've reached the maximum number of 100, because each of the 25 apps always has a default attribute.

  10. Click Add.

    The category appears in the Manage user attributes page.

    You can enter values for the custom attribute on the User information page for a user only. You can't enter these values by uploading a file with user account information.

Edit or delete custom attributes and categories

When organization-specific information changes, you might need to update or delete categories or custom attributes, such as making some attribute values public to all users in your organization.

  1. Sign in to your Google Admin console.

    Sign in using your administrator account (does not end in @gmail.com).

  2. From the Admin console Home page, go to Users.
  3. At the top of Users list, click Manage user attributes User attributes.
  4. Under Custom attributes, click the category you want to edit or delete.
  5. (Optional) To edit a category:
    1. (Optional) To edit text, click in a text field.
    2. (Optional) To change an attribute's visibility, select another option in the drop-down list.
    3. (Optional) To delete an attribute, click Remove Remove.
    4. Click Save.
  6.  (Optional) To delete a category:
    1. Click Delete at the lower left.
    2. Review the message and click Delete to confirm.
Add values to custom attributes

You can add or update values for custom attributes on the User information page for a user.

  1. Sign in to your Google Admin console.

    Sign in using your administrator account (does not end in @gmail.com).

  2. From the Admin console Home page, go to Users.
  3. In the Users list, find the user. If you need help, see Find a user account.
  4. Click the user’s name to open their account page.
  5. Click User information.
  6. Click any of the custom attribute sections to edit it.
  7. Add or change values to custom attributes.
  8. Click Save.

Note: You can't add or update custom attribute values by uploading a file with user account information.

Related topics

 

Was this article helpful?
How can we improve it?