Table of contents

This article aims to provide you with information regarding what Custom User Attributes are and how to create them.


What are they and how do they work?

Custom User Attributes include additional information shown within your Happeo User Profile aside from the standard Google or Okta Directory Fields.

This additional information allows for much richer profiles (e.g. details about interests, skill sets, preferred pronouns, etc.) and faster searches.


Furthermore, only public attributes will be displayed on Happeo while attributes only visible to administrators will not be shown.

How often are custom attributes synced?

The synchronization happens automatically every 24 hours.

How to create a custom attribute in Google

Below, you can find a tutorial from Google:

  1. You can create a custom user attributes schema here by clicking Manage custom attributesCustom_User_Attributes_1.png
  2. Select Add custom attribute
  3. Add fields into the created schema. These fields should make the organization's visible fields available only for sync and visible in Happeo 
    1. The info type should be set to Text
    2. The visibility should be set to Visible to organization
    3. The number of values should be set to Single or Multiple valueCustom_User_Attributes_2.png
  4. By completing the previous steps, a user or administrator is then able to edit newly created fields
    1. For instance, if you navigate back here
    2. Click your user profile
    3. Click the downward arrow on the right side of User information
    4. And scroll down until you see your recently created custom attribute
    5. You can click the pencil / edit symbol on the right side of it (it will appear once you hover over it)
    6. And you can write whatever you like in the field
  5. After Happeo synchronizes with Google Workspace, the Custom Attributes become searchable and available on the user’s profile. Moreover, the name of the schema becomes the section title


How to create a custom attribute in Okta

From the Dashboard in Okta:

  1. Click Directory from the navigation menu and Profile editorCustom_User_Attributes_3.png
  2. From the Users tab, select the Happeo App (by clicking the application name)

  3. Then, click Add attribute

You can find the following settings below:

  • Data type – Set to string
  • Display name – The label you wish to display (e.g. skills, hobbies, favorite music genre, etc.)
  • Variable name – This is used to refer to the attribute in profile mappings and expressions (e.g. skills, hobbies, etc.)
  • External namespace – Fill in as: urn:ietf:params:scim:schemas:extension:happeo:2.0:User
  • Description – A description of the label you are displaying (e.g. the user’s skills)
  • Enum – Needs to be checked if there are only predefined fields that users can choose from (e.g. Monday, Tuesday….Sunday)
  • Attribute length – The customizable length of an attribute
  • Attribute required – Needs to be checked when creating a user or a group
  • Scope – Check the box User personal


After filling in the necessary information, you can click Save

On the Profile editor page, you can scroll down the Attributes list to find the new attribute you created.


To add the attribute to your Happeo environment, click on Mappings under the Attributes tab. 


Then, you can:

  1. Click Okta User to Happeo
  2. Scroll down and click Choose an attribute or enter an expression
  3. You can then add the mapping related to the attribute you created
  4. Make sure to preview the mapping to ensure that it maps properly. You can do this by entering an Okta user in the Preview field at the bottom of the page

  5. Once everything looks good, you can click on Save Mappings




If users are already assigned to the Happeo app, we should receive an update from Okta as soon as you start adding values to the new attribute.

If they are not assigned to the app, we would get the whole user profile together with the Custom Attribute when this is synched in Happeo.

Once the users have been updated, you can find the new attributes under the Additional Info tab in the User Profile



How to create a custom attribute in Azure AD

First, open your Azure Active Directory portal.

If your custom user attribute is not yet present in the User profile, you can:

  1. Go to External Identities
  2. Click Custom User Attributes
  3. Click Add


Then you can:

  1. Navigate to Enterprise Applications
  2. Open the Provisioning tab of the Happeo Enterprise Application
  3. Under Mappings, select the object (user or group) for which you'd like to add a custom attribute
  4. At the bottom of the page, select Show advanced options
  5. Select Edit attribute list for AppName
  6. At the bottom of the attribute list, enter information about the custom attribute in the fields provided
  7. Create a new custom attribute with Happeo attributes naming: 
    1. urn:ietf:params:scim:schemas:extension:happeo:2.0:User:Custom_Attribute
    2. Column value for type will remain as String
  8. Save your changes

From there you can:

  1. Click Add new mapping at the bottom-left of the page for users
  2. Select the source attribute
  3. Select the newly created target attribute
    1. urn:ietf:params:scim:schemas:extension:happeo:2.0:User:Custom_Attribute
  4. Click OK
  5. Save your changes

Once the sync has been forced from the Azure provisioning, you can find the new attributes under the Additional Info tab in the User Profile