diff --git a/.changeset/tricky-jobs-clap.md b/.changeset/tricky-jobs-clap.md
index c11acc7318..e773a888c7 100644
--- a/.changeset/tricky-jobs-clap.md
+++ b/.changeset/tricky-jobs-clap.md
@@ -3,4 +3,32 @@
 '@backstage/plugin-scaffolder': minor
 ---
 
-Replace `ui:widget: password` with the `ui:field: Secret` implementation
+Replace `ui:widget: password` with the a warning message stating that it's not secure and to use the build in `SecretField`.
+
+You can do this by updating your `template.yaml` files that have the reference `ui:widget: password` to `ui:field: Secret` instead.
+
+```diff
+apiVersion: backstage.io/v1alpha1
+kind: Template
+metadata:
+  ...
+
+spec:
+  parameters:
+    - title: collect some information
+      schema:
+        type: object
+        properties:
+          password:
+            title: Password
+            type: string
+-            ui:widget: password
++            ui:field: Secret
+  steps:
+    - id: collect-info
+      name: Collect some information
+      action: acme:do:something
+      input:
+-        password: ${{ parameters.password }}
++        password: ${{ secrets.password }}
+```