diff --git a/docs/components/console/manage-clusters/manage-secrets.md b/docs/components/console/manage-clusters/manage-secrets.md
index 2650514e97e..0136405a3f6 100644
--- a/docs/components/console/manage-clusters/manage-secrets.md
+++ b/docs/components/console/manage-clusters/manage-secrets.md
@@ -27,6 +27,24 @@ To create a new secret, go to your cluster and take the following steps:
 
 ![secrets-view](./img/cluster-detail-secrets-view.png)
 
+## Use secrets in a workflow
+
+Secrets are used inside connector tasks in your BPMN model. Add a connector task, then reference the secret key in a field that supports secrets.
+
+Example for a plain text field (for example, an authorization header value):
+
+```
+Bearer {{secrets.MY_API_KEY}}
+```
+
+Example for a FEEL expression (note the double quotes around the placeholder):
+
+```feel
+= { myHeader: "{{secrets.MY_API_KEY}}" }
+```
+
+For more details on where secrets are supported, see the [Connectors guide](/components/connectors/use-connectors/index.md#using-secrets).
+
 Now you can reference your secret in any connector as described in the [Connectors guide](/components/connectors/use-connectors/index.md#using-secrets).
 
 :::note
diff --git a/versioned_docs/version-8.8/components/console/manage-clusters/manage-secrets.md b/versioned_docs/version-8.8/components/console/manage-clusters/manage-secrets.md
index 2650514e97e..35539534e97 100644
--- a/versioned_docs/version-8.8/components/console/manage-clusters/manage-secrets.md
+++ b/versioned_docs/version-8.8/components/console/manage-clusters/manage-secrets.md
@@ -27,6 +27,24 @@ To create a new secret, go to your cluster and take the following steps:
 
 ![secrets-view](./img/cluster-detail-secrets-view.png)
 
+## Use secrets in a workflow
+
+Secrets are used inside connector tasks in your BPMN model. Add a connector task, then reference the secret key in a field that supports secrets.
+
+Example for a plain text field (for example, an authorization header value):
+
+```
+Bearer {{secrets.MY_API_KEY}}
+```
+
+Example for a FEEL expression (note the double quotes around the placeholder):
+
+```
+= { myHeader: "{{secrets.MY_API_KEY}}" }
+```
+
+For more details on where secrets are supported, see the [Connectors guide](/components/connectors/use-connectors/index.md#using-secrets).
+
 Now you can reference your secret in any connector as described in the [Connectors guide](/components/connectors/use-connectors/index.md#using-secrets).
 
 :::note