> For the complete documentation index, see [llms.txt](https://ztrust.gitbook.io/ztrust-documentation/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://ztrust.gitbook.io/ztrust-documentation/user-manual-ztrust-v4.1/4.-admin-manual/4.11-user-profile-custom-attributes.md).
# 4.11 User Profile – Custom Attributes
ZTrust allows administrators to extend the default user profile by adding **custom attributes** such as *Employee ID*, *Department*, or *Phone Number*.
With the **User Profile feature** you can:
* Define attributes at the **realm level** with validation rules.
* Control whether fields are **mandatory, optional, or read-only**.
* Decide where attributes appear: **Admin Console, Self Service Portal, Registration form**.
* Ensure **data consistency and validation** across all users.
## Steps to Create Custom Attributes
1. Login to the **ZTrust Admin Console**.
Fig 4.10.a: Master realm
2. Click on **Manage Realms** in the sidebar to view the list of realms available in your **ZTrust**.
Fig 4.10.b: Choose realm
3. From the list of **realms**, **select** the realm where you want to create custom attributes.
Fig 4.11.c: Welcome to demo realm
4. In the left sidebar, under the **Configure** section, choose **Realm Settings**.
Fig 4.10.d: Realm settings in side bar
5. In the R**ealm Settings** section, click on the **User Profile** tab. This will display the list of available attributes.
Fig 4.10.e: Select user profile tab
6. To create a new custom attribute, click on the ***Create Attribute*** button. This will open a new page.
Fig 4.10.f: Create attribute
7. Configure the attribute:
| Field | Description |
| ---------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| Name | Internal key (e.g., `employeeId`) |
| **Display Name** | User-friendly label (e.g., *Employee ID*) |
| Required | Mark as mandatory if needed |
| Permissions |
Choose who can view/edit :
Admin only
User (self-service)
Both
|
| Validations |
Add constraints:
Regex → e.g., ^\[0-9]+$ for numeric IDs
Length → min/max characters
Options → dropdown values (e.g., IT, HR, Finance)
|
8. After filling in all the mandatory fields, click the *Create* button.
## Conclusion
User Profile attributes provide a structured way to manage custom fields. They can be customized with validations, permissions, and UI hints, and they automatically appear in the Admin Console, Self Service Portal, and Registration pages.