diff --git a/.changeset/brown-wombats-jump.md b/.changeset/brown-wombats-jump.md
new file mode 100644
index 00000000000..6e66a00b345
--- /dev/null
+++ b/.changeset/brown-wombats-jump.md
@@ -0,0 +1,7 @@
+---
+"@wso2is/admin.authentication-flow-builder.v1": patch
+"@wso2is/admin.applications.v1": patch
+"@wso2is/i18n": patch
+---
+
+update secret management script editor placeholder
diff --git a/features/admin.applications.v1/components/settings/sign-on-methods/script-based-flow/script-based-flow.tsx b/features/admin.applications.v1/components/settings/sign-on-methods/script-based-flow/script-based-flow.tsx
index 566750eccf4..347e5421997 100644
--- a/features/admin.applications.v1/components/settings/sign-on-methods/script-based-flow/script-based-flow.tsx
+++ b/features/admin.applications.v1/components/settings/sign-on-methods/script-based-flow/script-based-flow.tsx
@@ -874,10 +874,12 @@ export const ScriptBasedFlow: FunctionComponent<AdaptiveScriptsPropsInterface> =
                                     "emptyPlaceholder.description"
                                 }
                             >
-                                    Securely store access keys as secrets. A secret can
-                                    replace the consumer secret in <OxygenCode variant="caption">
-                                        callChoreo()</OxygenCode> function
-                                    in the conditional authentication scripts.
+                                You can securely store sensitive information, such as
+                                API keys and other secrets, for use in conditional
+                                authentication scripts. Once stored, these secrets can
+                                be referenced in your scripts using the syntax
+                                <OxygenCode variant="caption">{ "secrets.{secret_name}" }
+                                </OxygenCode>.
                             </Trans>
                         </Typography>
                     </ListItemText>
diff --git a/features/admin.authentication-flow-builder.v1/components/script-editor-panel/secret-selection-dropdown.tsx b/features/admin.authentication-flow-builder.v1/components/script-editor-panel/secret-selection-dropdown.tsx
index e5447beb91d..314a9854cbc 100644
--- a/features/admin.authentication-flow-builder.v1/components/script-editor-panel/secret-selection-dropdown.tsx
+++ b/features/admin.authentication-flow-builder.v1/components/script-editor-panel/secret-selection-dropdown.tsx
@@ -170,10 +170,11 @@ const SecretSelectionDropdown = (props: SecretSelectionDropdownPropsInterface):
                                             "emptyPlaceholder.description"
                                         }
                                     >
-                                            Securely store access keys as secrets. A secret can
-                                            replace the consumer secret in <Code variant="caption">
-                                                callChoreo()</Code> function
-                                            in the conditional authentication scripts.
+                                        You can securely store sensitive information, such as
+                                        API keys and other secrets, for use in conditional
+                                        authentication scripts. Once stored, these secrets can
+                                        be referenced in your scripts using the syntax <Code variant="caption">
+                                            { "secrets.{secret_name}" }</Code>.
                                     </Trans>
                                 </Typography>
                             </ListItemText>
diff --git a/modules/i18n/src/translations/en-US/portals/applications.ts b/modules/i18n/src/translations/en-US/portals/applications.ts
index 8553a3eb531..8a135932c1e 100644
--- a/modules/i18n/src/translations/en-US/portals/applications.ts
+++ b/modules/i18n/src/translations/en-US/portals/applications.ts
@@ -641,9 +641,10 @@ export const applications: ApplicationsNS = {
                                     emptyPlaceholder: "No secrets available",
                                     search: "Search by secret name",
                                     tooltips: {
-                                        keyIcon: "Securely store access keys as secrets. A secret can " +
-                                            "replace the consumer secret in <1>callChoreo()</1> function " +
-                                            "in the conditional authentication scripts.",
+                                        keyIcon: "You can securely store sensitive information, such as " +
+                                            "API keys and other secrets, for use in conditional " +
+                                            "authentication scripts. Once stored, these secrets can " +
+                                            "be referenced in your scripts using the syntax <1>secrets.{secret name}</1>",
                                         plusIcon: "Add to the script"
                                     }
                                 }
diff --git a/modules/i18n/src/translations/en-US/portals/authentication-flow.ts b/modules/i18n/src/translations/en-US/portals/authentication-flow.ts
index 867859b7d2d..5323b71a5ff 100644
--- a/modules/i18n/src/translations/en-US/portals/authentication-flow.ts
+++ b/modules/i18n/src/translations/en-US/portals/authentication-flow.ts
@@ -256,7 +256,7 @@ export const authenticationFlow: AuthenticationFlowNS = {
             },
             emptyPlaceholder: {
                 header: "No secrets available.",
-                description: "Securely store access keys as secrets. A secret can replace the consumer secret in <1>callChoreo()</1> function in the conditional authentication scripts."
+                description: "You can securely store sensitive information, such as API keys and other secrets, for use in conditional authentication scripts. Once stored, these secrets can be referenced in your scripts using the syntax <1>secrets.{secret name}</1>."
             },
             label: "Add Secret"
         },