diff --git a/docs/documentation/server_admin/topics/workflows/understanding-common-use-cases.adoc b/docs/documentation/server_admin/topics/workflows/understanding-common-use-cases.adoc
index 6574b2c9d2f..9e8b46327ac 100644
--- a/docs/documentation/server_admin/topics/workflows/understanding-common-use-cases.adoc
+++ b/docs/documentation/server_admin/topics/workflows/understanding-common-use-cases.adoc
@@ -12,13 +12,13 @@ When a new user is created, a workflow can automatically send a welcome email, a
 
 ```yaml
 name: Onboarding gold members
-on: user_created
+on: user-created
 if: has-user-attribute('membership','gold')
 steps:
   - uses: notify-user
     with:
       message: "Welcome to the Gold Membership program!"
-  - uses: assign-user-role
+  - uses: grant-role
     with:
       role: gold-member
 ```
diff --git a/docs/documentation/server_admin/topics/workflows/understanding-workflow-definition.adoc b/docs/documentation/server_admin/topics/workflows/understanding-workflow-definition.adoc
index 778f04a126e..1ba5a612304 100644
--- a/docs/documentation/server_admin/topics/workflows/understanding-workflow-definition.adoc
+++ b/docs/documentation/server_admin/topics/workflows/understanding-workflow-definition.adoc
@@ -11,7 +11,7 @@ In its simplest form, a workflow definition can be defined as follows:
 
 ```yaml
 name: Onboarding new users
-on: user_added
+on: user_created
 steps:
   - uses: notify-user
     with: