From edc22a569dbac95ae94351dc44963c4b892e181b Mon Sep 17 00:00:00 2001
From: Thilina Shashimal Senarath
 <43197743+shashimalcse@users.noreply.github.com>
Date: Tue, 11 Jun 2024 17:21:34 +0530
Subject: [PATCH] Add a note to announce the changes in application role
 audience behavior. (#4618)

* Add a note to announce the change in application role audience behavior.
---
 en/includes/guides/api-authorization.md | 6 +++++-
 1 file changed, 5 insertions(+), 1 deletion(-)

diff --git a/en/includes/guides/api-authorization.md b/en/includes/guides/api-authorization.md
index f60c6b809a..a3eab75bf7 100644
--- a/en/includes/guides/api-authorization.md
+++ b/en/includes/guides/api-authorization.md
@@ -188,10 +188,14 @@ To select the application audience,
 
     1. If the choice is set to **Application**, all application roles created for the application appear under **Assigned Roles**. Click the **X** icon if you wish to delete an application role. Click **New Role** if you wish to add more roles.
 
-    2. Selecting **Organization** allows applications to consume organization-level APIs.
+    2. Selecting **Organization** allows applications to consume organization-level roles.
 
     !!! warning
         If you switch the role audience to **Organization**, application roles created for the application will be permanently deleted.
+    {% if product_name == ""WSO2 Identity Server" %}    
+    !!! note
+        In WSO2 Identity Server versions prior to update level 25, if the application's role audience is set to organization, users were required to manually assign organization-level roles to the application . This behavior has since changed. Now, all organization-level roles are automatically assigned to the application by default. If you are experiencing the previous behavior, download the updated [product pack](https://wso2.com/identity-server/) to receive the latest changes.
+    {% endif %}    
 
 ## Create roles and assign users