Skip to content

Update Managed In User Store related docs #5707

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Open
wants to merge 2 commits into
base: master
Choose a base branch
from
+25 −1
Open

Update Managed In User Store related docs #5707

Show file tree
Hide file tree
Changes from all commits
Commits
Show all changes
2 commits
Select commit Hold shift + click to select a range
cb6a5c7
Update managed in user store docs
PasinduYeshan Nov 13, 2025
5838f46
Rename image
PasinduYeshan Nov 13, 2025
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
Binary file added .../img/guides/organization/attributes/configure-attribute-excluded-user-store.png
View file
Open in desktop
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Binary file added ...mg/guides/organization/attributes/configure-attribute-managed-in-user-store.png
View file
Open in desktop
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Binary file added .../img/guides/organization/attributes/configure-attribute-excluded-user-store.png
View file
Open in desktop
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Binary file added ...mg/guides/organization/attributes/configure-attribute-managed-in-user-store.png
View file
Open in desktop
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
26 changes: 25 additions & 1 deletion en/includes/guides/users/attributes/manage-attributes.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -377,7 +377,31 @@
- Self-service portal user profile
![User creation wizard - dropdown input]({{base_path}}/assets/img/guides/organization/attributes/configure-attribute-input-format-self-service-view.png){: width="600" style="display: block; margin: 0; border: 0.3px solid lightgrey;"}

7. Under **Attribute Configurations**, use the table to configure how attributes are handled for each entity.
7. **Manage in User Store**

The **Manage in User Store** option determines where the attribute values are stored and managed.

Check warning on line 382 in en/includes/guides/users/attributes/manage-attributes.md

View workflow job for this annotation

GitHub Actions / Vale style check 

[vale] reported by reviewdog 🐶
[write-good.Passive] 'are stored' may be passive voice. Use active voice if you can.

Raw Output:
{"message": "[write-good.Passive] 'are stored' may be passive voice. Use active voice if you can.", "location": {"path": "en/includes/guides/users/attributes/manage-attributes.md", "range": {"start": {"line": 382, "column": 79}}}, "severity": "WARNING"}

Check warning on line 382 in en/includes/guides/users/attributes/manage-attributes.md

View workflow job for this annotation

GitHub Actions / Vale style check 

[vale] reported by reviewdog 🐶
[write-good.E-Prime] Try to avoid using 'are'.

Raw Output:
{"message": "[write-good.E-Prime] Try to avoid using 'are'.", "location": {"path": "en/includes/guides/users/attributes/manage-attributes.md", "range": {"start": {"line": 382, "column": 79}}}, "severity": "INFO"}

Check warning on line 382 in en/includes/guides/users/attributes/manage-attributes.md

View workflow job for this annotation

GitHub Actions / Vale style check 

[vale] reported by reviewdog 🐶
[Microsoft.Passive] 'are stored' looks like passive voice.

Raw Output:
{"message": "[Microsoft.Passive] 'are stored' looks like passive voice.", "location": {"path": "en/includes/guides/users/attributes/manage-attributes.md", "range": {"start": {"line": 382, "column": 79}}}, "severity": "INFO"}

![Managed in User Store]({{base_path}}/assets/img/guides/organization/attributes/configure-attribute-managed-in-user-store.png){: width="600" style="display: block; margin: 0; border: 0.3px solid lightgrey;"}

Check warning on line 384 in en/includes/guides/users/attributes/manage-attributes.md

View workflow job for this annotation

GitHub Actions / Vale style check 

[vale] reported by reviewdog 🐶
[Microsoft.Semicolon] Try to simplify this sentence.

Raw Output:
{"message": "[Microsoft.Semicolon] Try to simplify this sentence.", "location": {"path": "en/includes/guides/users/attributes/manage-attributes.md", "range": {"start": {"line": 384, "column": 168}}}, "severity": "INFO"}

- **Checked**: The attribute values are managed in the user store.

Check warning on line 386 in en/includes/guides/users/attributes/manage-attributes.md

View workflow job for this annotation

GitHub Actions / Vale style check 

[vale] reported by reviewdog 🐶
[write-good.Passive] 'are managed' may be passive voice. Use active voice if you can.

Raw Output:
{"message": "[write-good.Passive] 'are managed' may be passive voice. Use active voice if you can.", "location": {"path": "en/includes/guides/users/attributes/manage-attributes.md", "range": {"start": {"line": 386, "column": 41}}}, "severity": "WARNING"}

Check warning on line 386 in en/includes/guides/users/attributes/manage-attributes.md

View workflow job for this annotation

GitHub Actions / Vale style check 

[vale] reported by reviewdog 🐶
[write-good.E-Prime] Try to avoid using 'are'.

Raw Output:
{"message": "[write-good.E-Prime] Try to avoid using 'are'.", "location": {"path": "en/includes/guides/users/attributes/manage-attributes.md", "range": {"start": {"line": 386, "column": 41}}}, "severity": "INFO"}

Check warning on line 386 in en/includes/guides/users/attributes/manage-attributes.md

View workflow job for this annotation

GitHub Actions / Vale style check 

[vale] reported by reviewdog 🐶
[Microsoft.Passive] 'are managed' looks like passive voice.

Raw Output:
{"message": "[Microsoft.Passive] 'are managed' looks like passive voice.", "location": {"path": "en/includes/guides/users/attributes/manage-attributes.md", "range": {"start": {"line": 386, "column": 41}}}, "severity": "INFO"}
- **Unchecked**: The attribute values are managed internally by the system.

Check warning on line 387 in en/includes/guides/users/attributes/manage-attributes.md

View workflow job for this annotation

GitHub Actions / Vale style check 

[vale] reported by reviewdog 🐶
[write-good.Passive] 'are managed' may be passive voice. Use active voice if you can.

Raw Output:
{"message": "[write-good.Passive] 'are managed' may be passive voice. Use active voice if you can.", "location": {"path": "en/includes/guides/users/attributes/manage-attributes.md", "range": {"start": {"line": 387, "column": 43}}}, "severity": "WARNING"}

Check warning on line 387 in en/includes/guides/users/attributes/manage-attributes.md

View workflow job for this annotation

GitHub Actions / Vale style check 

[vale] reported by reviewdog 🐶
[write-good.E-Prime] Try to avoid using 'are'.

Raw Output:
{"message": "[write-good.E-Prime] Try to avoid using 'are'.", "location": {"path": "en/includes/guides/users/attributes/manage-attributes.md", "range": {"start": {"line": 387, "column": 43}}}, "severity": "INFO"}

Check warning on line 387 in en/includes/guides/users/attributes/manage-attributes.md

View workflow job for this annotation

GitHub Actions / Vale style check 

[vale] reported by reviewdog 🐶
[Microsoft.Passive] 'are managed' looks like passive voice.

Raw Output:
{"message": "[Microsoft.Passive] 'are managed' looks like passive voice.", "location": {"path": "en/includes/guides/users/attributes/manage-attributes.md", "range": {"start": {"line": 387, "column": 43}}}, "severity": "INFO"}

When the Manage in User Store option is selected, you can further refine this behavior in the Attribute Mappings tab.

Check failure on line 389 in en/includes/guides/users/attributes/manage-attributes.md

View workflow job for this annotation

GitHub Actions / lint

Trailing spaces 

en/includes/guides/users/attributes/manage-attributes.md:389:122 MD009/no-trailing-spaces Trailing spaces [Expected: 0 or 2; Actual: 1] https://github.com/DavidAnson/markdownlint/blob/v0.38.0/doc/md009.md
There, you can exclude specific user stores by clearing the Manage in User Store checkbox for those stores.

Check failure on line 390 in en/includes/guides/users/attributes/manage-attributes.md

View workflow job for this annotation

GitHub Actions / lint

Trailing spaces 

en/includes/guides/users/attributes/manage-attributes.md:390:112 MD009/no-trailing-spaces Trailing spaces [Expected: 0 or 2; Actual: 1] https://github.com/DavidAnson/markdownlint/blob/v0.38.0/doc/md009.md
The attribute values for the excluded user stores will then be managed internally by the system.

![Selective Manage in User Store]({{base_path}}/assets/img/guides/organization/attributes/configure-attribute-excluded-user-store.png){: width="600" style="display: block; margin: 0; border: 0.3px solid lightgrey;"}

!!! Danger "Warning"
Changing the attribute storage location may cause any existing attribute values stored in the user store or

Check failure on line 396 in en/includes/guides/users/attributes/manage-attributes.md

View workflow job for this annotation

GitHub Actions / lint

Trailing spaces 

en/includes/guides/users/attributes/manage-attributes.md:396:116 MD009/no-trailing-spaces Trailing spaces [Expected: 0 or 2; Actual: 1] https://github.com/DavidAnson/markdownlint/blob/v0.38.0/doc/md009.md
managed internally to become inaccessible. Ensure that you understand the impact before making this change.

If you have configured a **Read-Only User Store** and enable **Manage in User Store** for an identity attribute,
the attribute will not be editable in the user profile. Consequently, certain internal functions that rely on
updating these attributes may not work as expected.


Check failure on line 403 in en/includes/guides/users/attributes/manage-attributes.md

View workflow job for this annotation

GitHub Actions / lint

Multiple consecutive blank lines 

en/includes/guides/users/attributes/manage-attributes.md:403 MD012/no-multiple-blanks Multiple consecutive blank lines [Expected: 1; Actual: 2] https://github.com/DavidAnson/markdownlint/blob/v0.38.0/doc/md012.md
8. Under **Attribute Configurations**, use the table to configure how attributes are handled for each entity.
Copy link

@coderabbitai coderabbitai bot Nov 13, 2025

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

⚠️ Potential issue | 🔴 Critical

Fix duplicate step numbering.

Both the "Attribute Configurations" section (line 404) and the "Attribute Mappings" section (line 444) are numbered as step 8. The Attribute Mappings section should be numbered as step 9.

Apply this diff to fix the step numbering:

- 8. Go to the **Attribute Mappings** tab and enter the attribute from each user store that you need to map.
+ 9. Go to the **Attribute Mappings** tab and enter the attribute from each user store that you need to map.

Also applies to: 444-444

🤖 Prompt for AI Agents 
In en/includes/guides/users/attributes/manage-attributes.md around line 404 (and
also at line 444), there's duplicate step numbering: the "Attribute
Configurations" section is step 8 and the "Attribute Mappings" section is also
labeled 8; change the numbering on the "Attribute Mappings" section at line 444
from "8." to "9." so the steps are sequential and unique.


![Edit attributes]({{base_path}}/assets/img/guides/organization/attributes/configure-attribute-profiles.png){: width="600" style="display: block; margin: 0; border: 0.3px solid lightgrey;"}

Expand Down Expand Up @@ -417,7 +441,7 @@

To display an attribute in the user creation form, select the **both** **Display** and **Required** checkboxes for the **Administrator Console** entity.

8. Go to the **Attribute Mappings** tab and enter the attribute from each user store that you need to map.

Check failure on line 444 in en/includes/guides/users/attributes/manage-attributes.md

View workflow job for this annotation

GitHub Actions / lint

Ordered list item prefix 

en/includes/guides/users/attributes/manage-attributes.md:444:1 MD029/ol-prefix Ordered list item prefix [Expected: 9; Actual: 8; Style: 1/2/3] https://github.com/DavidAnson/markdownlint/blob/v0.38.0/doc/md029.md

![Edit attribute mappings]({{base_path}}/assets/img/guides/organization/attributes/edit-attribute-mappings.png){: width="500" style="display: block; margin: 0; border: 0.3px solid lightgrey;"}

Expand Down
Loading