Merge pull request #5278 from DonOmalVindula/fix/30299

Add documentation for user creation wizard attribute profiles

Author: DonOmalVindula

en/asgardeo/docs/assets/img/guides/organization/attributes/user-wizard-attribute-profile.png

@@ -26,6 +26,10 @@ Let's look at how administrators can onboard users from the {{ product_name }} C
     - **First Name:** First name of the user. You can add/change this later.
     - **Last Name:** Last name of the user. You can add/change this later.
 
+    !!! note
+        You can include additional user details such as phone number, address, and other custom attributes when onboarding a user. This is done via
+        [attribute configurations]({{base_path}}/guides/users/attributes/manage-attributes/#configure-attributes).
+
     !!! note
 
         - A username is always unique to the organization and you can't change the username once it is created.
@@ -149,7 +153,7 @@ To resend the link/code:
 
     ![Resend link]({{base_path}}/assets/img/guides/users/resend-password-setup-link.png){: width="600" style="display: block; margin: 0; border: 0.3px solid lightgrey;"}
 
-Alternatively, administrators can use the resend-code API to resend the link or code as shown below. 
+Alternatively, administrators can use the resend-code API to resend the link or code as shown below.
 
 !!! abstract ""
 
@@ -195,7 +199,7 @@ Alternatively, administrators can use the resend-code API to resend the link or
             ]
             }'
         ```
-    
+
     The recovery scenario should be specified in the properties parameter of the API request body, as follows:
 
     - `ASK_PASSWORD`: When the user is pending to set up an initial password using the setup link.
@@ -249,7 +253,7 @@ To reset the password:
         If this option is selected, the owner or an administrator can set a temporary password for the user.
 
         !!! note
-            If the user is in pending admin forced password reset, once the admin resets the password, 
+            If the user is in pending admin forced password reset, once the admin resets the password,
             the account will get unlocked.
 
     ![Reset password]({{base_path}}/assets/img/guides/users/reset-password-of-user.png){: width="600" style="display: block; margin: 0; border: 0.3px solid lightgrey;"}
@@ -312,7 +316,7 @@ To lock a user account:
 Disabling a user's account prevents users from logging into applications or to the self-service My Account portal. It is intended to be a long-term and a more permanent measure than locking a user's account. Therefore, if you simply wish to restrict a user's access temporarily, it is recommended to use [account locking](#lock-a-user-account).
 
 !!! note "Enable account disabling"
-    
+
     Account disabling is not an option available for a user's account by default. If you wish to enable this option for your organization, refer to [account disabling]({{base_path}}/guides/account-configurations/account-disabling/).
 
 To disable a user account,

en/asgardeo/docs/assets/img/guides/users/add-user-form-attribute-profile.png

@@ -18,14 +18,16 @@ Let's look at how administrators can onboard users from the {{ product_name }} C
 ### Onboard single user
 
 1. On the {{ product_name }} Console, go to **User Management** > **Users**.
-2. Click **Add User** button and select **Single User** option and provide the following details:
+2. Click **Add User** button and select **Single User** option and provide the user's details.
 
     ![Add user]({{base_path}}/assets/img/guides/users/add-user-form.png){: width="600" style="display: block; margin: 0; border: 0.3px solid lightgrey;"}
 
     !!! note
-           - A username is always unique to the organization and you can't change the username once it is created.
-           - Instead of using a username to login, you can [configure email address as the username]({{base_path}}/guides/users/attributes/enable-email-as-username/). Then, you will be asked to enter the email address when logging in.
-           - The user can change the password set by the administrator from the [My Account Portal]({{base_path}}/guides/user-self-service/customer-self-service-portal/).
+        - The user's username is always unique to the organization and you can't change the username once it is created.
+        - Optionally, you can [configure email address as the username]({{base_path}}/guides/users/attributes/enable-email-as-username/). Then, the user must enter the email address when logging in.
+
+    !!! tip "Add additional fields to the user onboarding form"
+        The default form requests for basic information of the user. If you wish to include additional details, such as the user's phone number, address, and other custom attributes, you need to make these attributes available in the **Administrator Console**. Learn how to do so in [attribute configurations]({{base_path}}/guides/users/attributes/manage-attributes/#configure-attributes).
 
 3. You can either request the user to set the password or set one on the user's behalf.
 
@@ -148,7 +150,7 @@ To resend the link/code:
 
     ![Resend link]({{base_path}}/assets/img/guides/users/resend-password-setup-link.png){: width="600" style="display: block; margin: 0; border: 0.3px solid lightgrey;"}
 
-Alternatively, administrators can use the resend-code API to resend the link or code as shown below. 
+Alternatively, administrators can use the resend-code API to resend the link or code as shown below.
 
 !!! abstract ""
 
@@ -194,7 +196,7 @@ Alternatively, administrators can use the resend-code API to resend the link or
             ]
             }'
         ```
-    
+
     The recovery scenario should be specified in the properties parameter of the API request body, as follows:
 
     - `ASK_PASSWORD`: When the user is pending to set up an initial password using the setup link.
@@ -242,7 +244,7 @@ To reset the password:
         If this option is selected, the owner or an administrator can set a new password for the user.
 
         !!! note
-            If the user is in pending admin forced password reset, once the admin resets the password, 
+            If the user is in pending admin forced password reset, once the admin resets the password,
             the account will get unlocked.
 
     - **Invite user to reset the password:**
@@ -311,7 +313,7 @@ To lock a user account:
 Disabling a user's account prevents users from logging into applications or to the self-service My Account portal. It is intended to be a long-term and a more permanent measure than locking a user's account. Therefore, if you simply wish to restrict a user's access temporarily, it is recommended to use [account locking](#lock-a-user-account).
 
 !!! note "Enable account disabling"
-    
+
     Account disabling is not an option available for a users' accounts by default. If you wish to enable this option for your organization, refer to [account disabling]({{base_path}}/guides/account-configurations/account-disabling/).
 
 To disable a user account,

en/asgardeo/docs/guides/users/manage-users.md

@@ -136,6 +136,12 @@ To configure properties of user attributes:
         </tbody>
     </table>
 
+!!! note
+    Using the attribute configurations, you can also configure which attributes are displayed in the user creation form when
+    [onboarding users]({{base_path}}/guides/users/manage-users/#onboard-a-single-user) in the console.
+
+    To display an attribute in the user creation form, select the **both** **Display** and **Required** checkboxes for the **Administrator Console** entity.
+
 {% else %}
 
 ## Configure attributes
@@ -200,7 +206,7 @@ To configure properties of user attributes:
 !!! warning "Before you proceed"
 
     Attributes cannot be deleted if it has any associations with external schema. If you have attribute mappings, make sure you delete these associations before attempting to delete an attribute.
-    
+
     Refer to [Delete an OpenID Connect attribute]({{base_path}}/guides/users/attributes/manage-oidc-attribute-mappings/#delete-an-openid-connect-attribute) and [Delete a SCIM2 attribute]({{base_path}}/guides/users/attributes/manage-scim2-attribute-mappings/#delete-a-scim-20-custom-schema-attribute) to delete any existing associations.
 
 
@@ -236,7 +242,7 @@ datastore_type = "<Name of the identityDataStore class>"
 
     By making this configuration adjustment, you can ensure that your system aligns with your preferred data store class, whether it's the previous default or a custom class you've implemented. This helps you tailor the system to your specific needs.
 
-2.  Map the identity claims mentioned below to attributes in the underlying user store. 
+2.  Map the identity claims mentioned below to attributes in the underlying user store.
 
     !!! info
         Learn more about [adding claim mapping]({{base_path}}/guides/dialects/add-claim-mapping).