How to Add Custom Attributes in Google Workspace

This article provides step-by-step instructions for creating a custom attribute in Google Admin Console and configuring it for use in Crossware.

Create a Custom Attribute in Google Admin Console

1. Sign in to the Google Admin Console.
2. In the left navigation pane, select Directory.
3. Select Users.

4. From the More options menu, select Manage custom attributes.
    

   

5. Select Add custom attribute.
6. In the Category field, enter a category for the attribute.
7. In the Description field, enter a description for the attribute.
8. In the Field name box, enter a name relevant to your requirement.
9. Under Info type, select Text.
10. Under Visibility, select Visible to organization.
11. Under No. of values, select Single value.

12. Select Add to create the attribute.
     

    

Assign the Custom Attribute to a User

1. In the Admin Console, go to Users.
2. Select the relevant user.
3. Expand the User information section.
4. Enter the required values in the custom attribute field.

5. Select Save.

   

Configure the Attribute in Crossware Portal

1. Open a new browser tab and sign in to the Crossware Portal using your Google account.
2. From the navigation bar, select the Fields icon.
3. Select Create directory field.
4. Enter a Title for the field.
5. In the Directory Attribute field, type the following format: customSchemas:[Category]:[FieldName]
    
   • Note: Replace [Category] with the custom attribute category you created in Google Admin, and [FieldName] with the specific field name.
     For example, the category is Pronouns and the field name is Pronouns, you would enter:
     customSchemas:Pronouns:Pronouns

6. Select Save & Close.
    

   

After completing this configuration, perform a test send to verify that the attribute value is being pulled through correctly.
 

The custom attribute is now available for use in Crossware and can be dynamically added to signature blocks.