Merge pull request #5728 from AmshikaH/master

Add upcoming sub-organization change details

Author: AmshikaH

en/includes/guides/organization-management/inheritance-in-organizations/index.md

@@ -19,3 +19,57 @@ The following guides explain how inheritance works for each of these features:
 - **[Email and SMS template]({{base_path}}/guides/organization-management/inheritance-in-organizations/email-sms-templates-inheritance/)**: Learn how customizations to Email and SMS templates propagate in an organization hierarchy.
 
 - **[Flow inheritance]({{base_path}}/guides/organization-management/inheritance-in-organizations/flow-inheritance/)**: Learn how organizations inherit Flows.
+
+!!! info Upcoming Enhancements to Organization Management
+
+{% if product_name == "Asgardeo" %}
+
+    We are rolling out a new set of changes for organizations that introduce hierarchical inheritance for the following features.
+
+    - Login and registration settings
+    - Configurations of the following connections:
+        - SMS OTP
+        - Push Notifications
+        - Email OTP
+        - Passkey connection
+    - Flows
+        - Self-registration flows
+        - Password recovery flows
+        - Invited user registration flows
+    - OIDC scopes
+    - Attribute update verification settings
+    - User attributes (claims)
+
+    ## Summary of Upcoming Changes
+
+    - **Login & Registration Settings and Flows**
+
+        - Previously: These configurations were not inherited by child organizations, and customization at the child level was not possible.
+
+        - After the update: Child organizations will automatically inherit login and registration settings and flows from the parent organization, including any designed self-registration, password recovery and invited user registration flows. Any customizations that an organization makes will cascade down to child organizations. Child organizations can override the inherited settings.
+
+    - **Connections**
+
+        - Previously: SMS OTP, Push Notification, Email OTP and Passkey connection configurations were not inherited by child organizations, and customizations at the child level was not possible.
+
+        - After the update: Child organizations will automatically inherit these connection configurations from the parent organization. Additionally, child organizations can override the settings for Email OTP and SMS OTP connections.
+
+    - **Custom User Attributes (Claims)**
+
+        - Previously: Custom user attributes were shared with child organizations only if they were shared via a B2B SaaS application.
+
+        - After the update: Child organizations will automatically inherit custom user attributes (claims) defined in the root organization. The inherited attributes will function in the same way as they did under the explicit sharing model, however, additional custom attributes that were not shared previously will now be available in the child organization.
+
+    - **OIDC Scopes**
+
+        - Previously: Child organizations did not inherit OIDC scopes from parent organizations and instead relied on system default values.
+
+        - After the update: Child organizations will automatically inherit OIDC scopes configured in the root organization.
+
+    - **Attribute Update Verification Settings**
+
+        - Previously: Child organizations did not inherit email and mobile number verification and notification settings related to user attribute updates.
+
+        - After the update: Child organizations now automatically inherit email and mobile number verification and notification settings for user attribute updates from the parent organization.
+
+{% endif %}