✖
 
 

Attribute List

Overview

The Attribute List is the panel within the Self Update Layout editor that contains all the fields administrators can expose to end users for self-service profile updates. It is divided into two categories:

By selectively dragging fields from the Attribute List into the layout canvas, administrators control exactly which pieces of directory information users are allowed to view and edit, without IT intervention.

General attributes

General attributes correspond directly to standard AD user object properties. They are grouped into four categories in the Attribute List panel on the left side of the layout editor.

User Profile

General attributes in the user profile in ADSelfService Plus

FieldNotes
Display NameThe name shown in the directory and address book.
Full NameThe user's full legal name.
Logon NameThe user's UPN-format logon name (e.g., user@domain.com).
User Logon Name (pre-Windows 2000)Legacy SAM-account name. Must be 20 characters or fewer. The following characters are not permitted: ` \ / [ ] : ;
Telephone NumberThe user's primary office telephone number.
E-mailThe user's primary email address.
Web PageURL of the user's personal or work web page.
DescriptionA free-text description field.
OfficeThe user's office location.
First NameThe user's given name.
Last NameThe user's surname.
InitialsThe user's initials.
Employee IDThe organization's internal employee identifier.
Employee NumberAn additional numeric employee reference field.

Contact

General attributes of contacts in ADSelfService Plus

FieldNotes
Home PhoneThe user's personal home phone number.
PagerThe user's pager number, if applicable.
MobileThe user's mobile/cell phone number.
FaxThe user's fax number.
IP PhoneThe user's VoIP phone number or extension.
NotesA free-text field for miscellaneous contact-related notes.

Address

General attributes for address details in the ADSelfService Plus user profile

FieldNotes
StreetThe user's street address. Renders as a multi-line text box.
P.O. BoxThe user's post office box number.
CityThe city or locality of the user's address.
State/ProvinceThe state or province of the user's address.
Zip/Postal CodeThe ZIP or postal code of the user's address.
Country/RegionThe country or region of the user's address.

Organization

General organizational attributes in the user profile in ADSelfService Plus

FieldNotes
TitleThe user's job title (e.g., Senior Engineer, Product Manager).
DepartmentThe department or business unit the user belongs to.
CompanyThe name of the organization or subsidiary the user is part of.
ManagerThe user's direct reporting manager. Populated from the directory — the value must correspond to a valid user object in Active Directory.

Custom Attributes

Custom Attributes allow administrators to extend the Self Update layout with fields beyond the built-in general attributes — for example, a badge number, cost center code, or any other LDAP attribute specific to your organization.

Note: You cannot create a custom attribute using the LDAP name of an attribute that already exists in the General Attributes list. If you attempt to do so, ADSelfService Plus will not allow the attribute to be added. Use the built-in general attribute instead.

Supported data types

When creating a custom attribute, select the data type that matches the underlying LDAP attribute:

Data TypeUse when…
Unicode StringThe attribute stores text (most common).
IntegerThe attribute stores a whole number.
BooleanThe attribute stores a true/false value.
Large IntegerThe attribute stores a large numeric value (e.g., timestamps).

Configuration steps

Adding a custom attribute field

Configuring custom attributes for self-updates in ADSelfService Plus

  1. Navigate to Configuration → Self-Service → Directory Self Service → Self Update Layout.
  2. Click the Edit icon next to the layout you want to modify.
  3. In the Attribute List panel on the left, expand Custom Attributes → +Add new field.
  4. Enter a Display Name — this is the label users will see on the self-update form.
  5. Enter the LDAP Name — this must exactly match the LDAP attribute name in your Active Directory schema.
  6. Select the appropriate Data Type from the dropdown.
  7. (Optional) Expand Advanced Settings to configure:
    • Unique Attribute — prevents duplicate values across users.
    • Sensitive Attribute — masks the field value for privacy.
  8. Click Add. The new field appears in the Custom Attributes section of the panel.
  9. Drag and drop the custom field from the panel into the desired position on the layout canvas.
  10. A Field Properties popup will appear — configure display options as needed.
  11. Click Save to apply the layout.

Modifying a custom attribute field

  1. Navigate to Configuration → Self-Service → Directory Self Service → Self Update Layout.
  2. Click the Edit icon next to the relevant layout.
  3. In the Attribute List panel, expand Custom Attributes.
  4. Click the Edit icon next to the custom field you want to change.
  5. Make your changes and click Update.

Deleting a custom attribute field

  1. Navigate to Configuration → Self-Service → Directory Self Service → Self Update Layout.
  2. Click the Edit icon next to the relevant layout.
  3. In the Attribute List panel, expand Custom Attributes.
  4. Click the Delete icon next to the field you want to remove.
Note: Deleting a custom attribute from the Attribute List also removes it from any layout it has been added to. This action cannot be undone.

Copyright © 2026, ZOHO Corp. All Rights Reserved.