Source: https://nishanth-fern-test.docs-staging.pageloop.ai/web/configure-user-identification-rules

# Configure Custom User Identification Rules

Advanced customization enables you to add custom rules for user identification directly using the Whatfix user interface (UI). Define specific criteria and conditions to segment user experiences based on roles, preferences, or other critical parameters, which creates a more user-centric environment. For example, create a user identification rule to identify users based on their login status.

Use the following steps to configure a custom user identification rule:

1. On the Whatfix Guidance dashboard, click **Settings**. ![ia\_left\_nav\_settings](/images/b8/ia_left_nav_settings-b868cdaa.png)

2. Click **Advanced customisation**. ![ia\_settings\_advanced configuration](/images/c0/ia_settings_advanced-configuration-c0ca1bbb.png)

3. Click **User rules**. ![click\_user\_rules](/images/54/click_user_rules-544a0282.png)

4. Click **Create**. ![set user\_create rule.png](/images/34/set-user_create-rule-3423cf54.png)

5. Select **User identification**, and then click **Continue**. ![Image](/images/b2/create_user_identification-b20a3e61.png)

6. Enter a **Rule Title**. ![Image](/images/81/image-XT8ZT9CP-8153609d.png)

7. Choose **Custom rule**. ![set user\_custom rule.png](/images/a1/set-user_custom-rule-a1745682.png)

> [!WARNING]
>
> - Select the **Enable user name capture on Desktop Apps** checkbox to use the end user’s desktop account name for user identification. You cannot create a custom rule if you have selected this option. ![set user\_enable desktop apps.png](/images/5f/set-user_enable-desktop-apps-5fb2902a.png)
> - Select the **Enable detection via SSO** checkbox to use the end user’s SSO authenticated IDs for user identification rules. ![set user\_enable detection via SSO.png](/images/e0/set-user_enable-detection-via-SSO-e07e9bfe.png)

1. In the **Where** section, select where you want the rule to take effect. ![ac\_set user\_select where.png](/images/16/ac_set-user_select-where-164f354e.png)

> [!INFO]
>
> Based on the desired location for the rule, set up any visibility conditions. For example, to enable the rule across all pages of the application, select **All Pages** as the type.
>
> Configure the rule's location based on any of the following conditions:
>
> - All Pages
> - [Page Tag](/web/tags-condition-rules)
> - [URL](/web/url-condition-rules)
> - [URL Hostname](/web/url-condition-rules)
> - [URL Path](/web/url-condition-rules)
> - [URL Parameter](/web/url-condition-rules)
> - [URL Hash](/web/url-condition-rules)

1. In the **What** section, configure how Whatfix identifies users. Use the **Where do you want to fetch the user from?** dropdown to select the source from which to pull the value that defines the user. For example, if each user has a unique identifier based on the cookie value, select **From Cookie** as fetcher. For more information, see [Fetch and process information for identification rules](/web/fetch-and-process-information-for-identification-rules). ![ac\_set user\_select fetcher.png](/images/c1/ac_set-user_select-fetcher-c18fbfd4.png)
2. In the **How do you want to process it?** dropdown, parse the fetched value using **JSON** or **String Operations**. For more information, see [Fetch and process information for identification rules](/web/fetch-and-process-information-for-identification-rules). ![ac\_set user\_select processor.png](/images/bc/ac_set-user_select-processor-bc8c41e0.png)

> [!INFO]
>
> - Add multiple processors to parse the fetched value. Click **Add Processor** to include another parsing method. ![ac\_set user\_add processor.png](/images/c2/ac_set-user_add-processor-c25d1a1a.png)
> - Click **Add Sequence** to include more identifiers. Fetch a different value and parse it for another unique identification rule. ![ac\_set user\_add sequence.png](/images/ce/ac_set-user_add-sequence-ce241d47.png)

1. Click **Save**. ![Image](/images/7c/image-HA9M24AJ-7cc68fce.png)
2. [Publish the changes to Production](/web/pushing-whatfix-content-to-production). ![Image](/images/32/image-EW5DCSPN-32fcc1e0.png)

> [!WARNING]
>
> - If you've used Advanced Customization (AC) code to set up User identification, Whatfix recommends removing the AC code after setting up User identification rules using the above-mentioned steps (Whatfix UI).
> - If User identification is configured using both AC code and Whatfix UI, the Whatfix UI configuration takes precedence over the AC code.

## Related

- [Understand Advanced Customization ](/web/advanced-configuration)
