In this Article

Profile fields are elements included on user profiles to either simply display information about the user (read-only); create a field visible only to admins (such as release number),  or provide a way for the user to specify unique information about him/herself. You can also include these fields on the registration form to capture the information at the moment someone joins your community rather than waiting for them to update their profile.

To include profile fields on user profiles, a user must belong to a profile field group then add a User profile fields widget on the user profile page and customize it to show the profile fields in the profile field group of his or her choice. If users have not yet specified information for these profile fields, they are not visible on the user's profile. But when a user edits the profile, he or she is able to add content to each profile field. You can also decide, for each profile field, whether community members should be able to search for similar members via that profile field by selecting Yes for search indexing question.

The profile fields for birthdate, gender, public email, website, location can't be deleted or changed by admins (thus prevented from breaking the site). You can pull only what has changed in a particular user's profile via the platform and in-process APIs.

The only fields indexed by search are plain text fields such as those entered in the profile. The default searchable fields include Birthday, Department, Education, Gender, Hobbies, Language, Occupation, and Title. HTML, URL, or check box fields are not indexed by Telligent Enterprise.

To support commas for searchable custom profile fields, change the field's data type to comma-separated list in User Profile Configuration.

By default, we include a set of profile fields grouped together in three groups:

  1. About: location, birthday, gender, language
  2. Contact: public email, blog, gallery, Web site, Facebook, AOL IM, Yahoo IM, Google IM, Windows Live IM
  3. Interests: occupation, hobbies, education

As an administrator you can modify these defaults, add additional fields to these existing groups, or create new groups to add to or replace these.

Profile fields

You can:

Add a custom profile field

  1. Navigate to Control Panel Dashboard > System Administration > Membership Administration > User Profile Configuration > Fields.



  2. Click Create New Field at the bottom of the list of existing profile fields. The Add User Profile Data Field dialog box appears.

  3. In the dialog window, specify:

    1. A unique Name used by the internal system to uniquely identify each profile field.
    2. The Label shown externally when a profile field widget is shown on a user's profile.
    3. In Searchable, whether the content of the profile field should be indexed by search to ensure it shows in search results.
    4. Type of Input field as it is displayed on a user's profile (for example, comma-separated list, URL, etc.).
  4. Click Save. The new profile field is displayed in the list of all profile fields shown in Step 1.

You must include the profile field in a profile field group before it is will become visible for editing or viewing on a user's profile.

Change an existing profile field

  1. Navigate to Control Panel Dashboard > System Administration > Membership Administration > User Profile Configuration > Fields.
  2. Click Edit next to the profile field you want to change. The edit dialog box appears.
  3. In the dialog window, specify:
    • Name - The name of the field.
    • Label - How the field is labeled in the Profile page.
    • Searchable - Whether or not the field is searchable.
    • Type of Input - including the following options:

      • Date 
      • Number
      • HTML
      • Multi-select
      • Plain text
      • Single-Select
      • URL

  4. Click Save. The profile field list is updated to display the changes you made.

Delete a profile field

  1. Navigate to Control Panel Dashboard > System Administration >  Membership Administration > User Profile Configuration > Fields.
  2. Click Delete next to the profile field you want to delete.
  3. Confirm the deletion and the list now no longer includes this profile field.

Add a custom profile field to a user profile

For this procedure to work, you have to have the User - Banner widget on your home page.

For a custom profile field to be visible, it must be included in a profile group. An existing profile fi|eld will already be part of a group (for example, the existing AOL IM name is part of the About group). A new field is not, by default, a member of any group and needs to be added - to either an existing group or a custom group. The process is the same for adding to either kind of group.

  1. Navigate to Control Panel Dashboard > System Administration > Membership Administration > User Profile Configuration > Field Groups.

  2. Click Edit for the profile field where you want to add the new field. (In this example, we're using the About profile field group.) The Add/Edit User Profile Field Data dialog box appears.
  3. Drag the custom field from Available fields to Current panel fields.



    Click Save. Now, when you or your user edits a user profile, this field will appear in the group where you placed it. (To edit a profile, see this article.)
  4. Go to your site (by clicking Go to site in the upper-right corner).
  5. Click your user profile, in this case Admin.
  6. Click Edit Profile in the upper-right corner of the user banner widget.
  7. Scroll down. You should now see your additional field in the About area (or whichever area you added it to).

Profile field groups

You can:

Add a custom profile field group

  1. Navigate to Control Panel Dashboard > System Administration > Membership Administration > User Profile Configuration > Field Groups.
  2. Click Create New Field Group at the bottom of the list of existing profile field groups. The Add/Edit User Profile Data Panel dialog window appears.
  3. In the dialog window:
    1. Specify a unique Name of the profile field group which will be shown on the profile field widget for selection of which profile field group to include. You cannot edit this name once it is created.
    2. Select one or more profile fields from the Available Fields list and drag and drop them in the Current Panel Fields list. Any fields in the Current Panel Fields list are included in the group in the order they appear in the Current Panel Fields list.
    3. You can remove profile fields from the group by dragging and dropping any fields from Current Panel Fields to Available Fields.
  5. Click Save. The new profile field group is displayed in the list of all profile field groups. You must include the profile field group in a profile field widget on a page (typically the user profile page) before it is visible for editing/viewing.

Change an existing profile field group

  1. Navigate to Control Panel Dashboard > System Administration > Membership Administration > User Profile Configuration > Field Groups.
  2. In the dialog window, click Edit next to the profile field group you want to change.
  3. Click Save.

Use caution when deleting profile fields or profile field groups. If you remove a profile field, it is automatically removed from the profile field group and the profile field widget (if enabled). Telligent Enterprise does, however, save any user-entered values for that profile field so that if you create a profile field with the same name and input type, that information will display for the user again (as long as you've recreated the profile field widget). If you remove a profile field group that is included in a profile field widget, the profile widget is automatically removed from its page.

Delete a profile field group

  1. Navigate to Control Panel Dashboard > System Administration > Membership Administration > User Profile Configuration > Fields Groups.
  2. Click Delete next to the profile field you want to delete.
  3. Confirm the deletion and the list now no longer includes this profile field group. Any profile field widgets that include this profile field group are reset to nothing so that this information no longer shows.