inititated inivited user registration doc

himeshsiriwardana · himeshsiriwardana · commit 46325b40822b · 2025-09-17T10:30:22.000+05:30
diff --git a/.vale/styles/Microsoft/Acronyms.yml b/.vale/styles/Microsoft/Acronyms.yml
@@ -8,6 +8,8 @@ first: '\b([A-Z]{3,5})\b'
 second: '(?:\b[A-Z][a-z]+ )+\(([A-Z]{3,5})\)'
 # ... with the exception of these:
 exceptions:
+  - OTP
+  - SMS
   - API
   - ASP
   - CLI
diff --git a/.vale/styles/Microsoft/Dashes.yml b/.vale/styles/Microsoft/Dashes.yml
diff --git a/.vale/styles/Microsoft/HeadingAcronyms.yml b/.vale/styles/Microsoft/HeadingAcronyms.yml
@@ -7,3 +7,4 @@ tokens:
   - '[A-Z]{2,4}'
 exceptions:
   - IP
+  - SMS OTP
diff --git a/en/base.yml b/en/base.yml
@@ -171,6 +171,9 @@ extra:
     Password Recovery:
       type: Preview
       level: 3
+    Invited User Registration:
+      type: Preview
+      level: 3
 
   nav_icons:
     Overview:
diff --git a/en/identity-server/next/docs/assets/img/guides/flows/flow-builder-invited-user-registration-final-flow.png b/en/identity-server/next/docs/assets/img/guides/flows/flow-builder-invited-user-registration-final-flow.png
diff --git a/en/identity-server/next/docs/assets/img/guides/flows/flow-invited-user-registration-step-01.gif b/en/identity-server/next/docs/assets/img/guides/flows/flow-invited-user-registration-step-01.gif
diff --git a/en/identity-server/next/docs/guides/flows/invited-user-registration.md b/en/identity-server/next/docs/guides/flows/invited-user-registration.md
@@ -0,0 +1 @@
+{% include "../../../../../includes/guides/flows/invited-user-registration.md" %}
diff --git a/en/identity-server/next/mkdocs.yml b/en/identity-server/next/mkdocs.yml
@@ -681,6 +681,7 @@ nav:
         - Get Started: guides/flows/build-a-flow.md
         - Self Registration: guides/flows/self-registration.md
         - Password Recovery: guides/flows/password-recovery.md
+        - Invited User Registration: guides/flows/invited-user-registration.md
       - User self-service:
         - User self-service: guides/user-self-service/index.md
         - Self-service portal:
diff --git a/en/includes/guides/flows/invited-user-registration.md b/en/includes/guides/flows/invited-user-registration.md
@@ -0,0 +1,49 @@
+# Invited user registration <div class="md-chip md-chip--preview"><span class="md-chip__label">Preview</span></div>
+
+**Invited User Registration** allows users to securely set their credentials after an administrator registers them in {{product_name}}.
+
+Once registered, the user receives an email to complete the sign-in process or use a link provided by the administrator offline. The user then clicks the email or link, verify their identity through a secure method (like an SMS or email OTP), and then set up a password.
+
+In the **Flow Builder**, you can create the invited user registration journey in two ways:
+
+- **Use a starter template** – Load a ready made flow and customize it to your needs.
+
+- **Build from scratch** – Take full control by designing every step yourself.
+
+## Sample use case
+
+Imagine you want to verify the user’s identity via **SMS OTP** before allowing them to reset their password. The flow works as follows:
+
+- The user clicks the link in the invitation email or pastes the URL in their browser.
+- A **one-time code** is sent to their registered mobile number.
+- The user verifies the code.
+- The user sets their password.
+
+This ensures that only users with access to the registered mobile number can complete the registration, enhancing security.
+
+![Invited user registration flow]({{base_path}}/assets/img/guides/flows/flow-builder-invited-user-registration-final-flow.png){: width="auto" style="display: block; margin: 0;"}
+
+## Build it
+
+To build the sample use case, we'll start from the **Invited User Registration** template and adjust it to:
+
+- Use **SMS OTP** for identity verification.
+- Require users to confirm their new password during reset.
+
+### Step 1 - Load the Invited User Registration Template
+
+![Step 1]({{base_path}}/assets/img/guides/flows/flow-invited-user-registration-step-01.gif){: width="auto" style="display: block; margin: 0;"}
+
+1. Navigate to **Home** > **Flows**.
+
+2. Click on the **Invited User Registration** card.
+
+3. Click the `+` button next to the **Invited User Registration** template.
+
+### Step 2 - Add an SMS OTP verification step
+
+This step verifies the user's mobile number provided during the registration before allowing them to set their password.
+
+1. Expand **Steps**, drag **Blank View** onto the canvas and place it between **Confirmation Code** and **Set Password**.
+
+   ![Step 2.1]({{base_path}}/assets/img/guides/flows/flow-invited-user-registration-step-02-1.gif){: width="auto" style="display: block; margin: 0;"}
diff --git a/en/includes/guides/flows/password-recovery.md b/en/includes/guides/flows/password-recovery.md
@@ -1,16 +1,16 @@
-# Password Recovery <div class="md-chip md-chip--preview"><span class="md-chip__label">Preview</span></div>
+# Password recovery <div class="md-chip md-chip--preview"><span class="md-chip__label">Preview</span></div>
 
 Password recovery allows users to reset their accounts when they lose access. This involves verifying their identity through a secure method, such as an email or SMS code, before letting them set a new password.
 
 In the **Flow Builder**, you can create a password recovery journey in two ways:
 
-- **Use a starter template** – Quickly load a ready made flow and customize it to your needs.
+- **Use a starter template** – Load a ready made flow and customize it to your needs.
 
-- **Build from scratch** – Design every step yourself for complete control.
+- **Build from scratch** – Take full control by designing every step yourself.
 
-## Sample Use Case
+## Sample use case
 
-A common recovery journey is to verify the user’s identity via **Email OTP** before allowing them to reset their password. The flow works as follows:
+Imagine you want to verify the user’s identity via **Email OTP** before allowing them to reset their password. The flow works as follows:
 
 - The user enters their **username**.
 - A **one-time code** is sent to their registered email.
@@ -21,7 +21,7 @@ To improve the default template, we’ll add a **“Back to application”** lin
 
 ![Final Flow]({{base_path}}/assets/img/guides/flows/flow-builder-password-recovery-final-flow.png){: width="auto" style="display: block; margin: 0;"}
 
-## Building the Sample Use Case
+## Build it
 
 This password recovery journey is based on the **Email OTP template**. Starting from the template, we’ll adjust it to:
 
@@ -34,29 +34,35 @@ Follow the steps below to configure this flow.
 
 ![Step 1]({{base_path}}/assets/img/guides/flows/flow-password-recovery-step-01.gif){: width="auto" style="display: block; margin: 0;"}
 
-1. Navigate to **Home → Flows**.
-2. Click on the the **password recovery** card.
+1. Navigate to **Home** > **Flows**.
+2. Click on the **password recovery** card.
 3. Click the `+` button next to the **Password Recovery with Email OTP** template.
 
-### Step 2 – Add a “Back to application” Link
+### Step 2 – Add a “Back to application” link
 
 If a user changes their mind or clicks the wrong option, they should have an easy way back to the application. Let’s make that possible by adding a link at the bottom of the `Forgot Password?` screen.
 
-1. Navigate to the **Components** section and drag and drop a **Rich Text** component to the **Forgot Password?** view.
-![Step 2.1]({{base_path}}/assets/img/guides/flows/flow-password-recovery-step-02-1.gif){: width="auto" style="display: block; margin: 0;"} <br>
+1. From the **Components** section, drag and drop a **Rich Text** component to the **Forgot Password?** view.
+
+    ![Step 2.1]({{base_path}}/assets/img/guides/flows/flow-password-recovery-step-02-1.gif){: width="auto" style="display: block; margin: 0;"} <br>
+
+2. Configure the Rich Text. To do so,
+
+    - In the Rich Text Editor, type: `Back to application`.  
+
+    - Change the style to **Heading 5** and **center align**.  
+
+    - Highlight the text, click the **Link** button, then click **Edit** in the popup window.  
 
-2. Configure the Rich Text <br>
-    2.1. In the Rich Text Editor, type: `Back to application`.  
-    2.2. Change the style to **Heading 5** and **center align**.  
-    2.3. Highlight the text, click the **Link** button, then click **Edit** in the popup window.  
    ![Step 2.2]({{base_path}}/assets/img/guides/flows/flow-password-recovery-step-02-2.gif){: width="auto" style="display: block; margin: 0;"} <br>
 
 3. From the dropdown, select **Callback or Application Access URL** and save.
-    ![Step 2.3]({{base_path}}/assets/img/guides/flows/flow-password-recovery-step-02-3.gif){: width="auto" style="display: block; margin: 0;"} <br>
+
+   ![Step 2.3]({{base_path}}/assets/img/guides/flows/flow-password-recovery-step-02-3.gif){: width="auto" style="display: block; margin: 0;"} <br>
 
 4. Click **Save Draft** to keep your progress.  
 
-### Step 3 – Require Password Confirmation
+### Step 3 – Require password confirmation
 
 The default reset screen asks for a new password once. Let’s make it more secure by requiring the user to confirm their password before submission.
 
diff --git a/en/includes/guides/flows/self-registration.md b/en/includes/guides/flows/self-registration.md
@@ -1,16 +1,16 @@
-# Self Registration <div class="md-chip md-chip--preview"><span class="md-chip__label">Preview</span></div>
+# Self registration <div class="md-chip md-chip--preview"><span class="md-chip__label">Preview</span></div>
 
 Self registration allows new users to create an account without admin intervention. The flow can include steps to collect user details, verify identity and set credentials before the account becomes active.
 
 In the **Flow Builder**, you can create a self registration journey in two ways:
 
-- **Use a starter template** – Quickly load a ready made flow and customize it to match your onboarding requirements.
+- **Use a starter template** – Load a ready made flow and customize it to match your onboarding requirements.
 
-- **Build from scratch** – Design each step yourself for full control over the user experience and security checks.
+- **Build from scratch** – Take full control by designing every step yourself.
 
-## Sample Use Case
+## Sample use case
 
-Let’s consider a practical example. Imagine you want to simplify user sign up by asking only for essential details, but also enforce stronger security with mobile verification.
+Imagine you want to simplify user sign up by asking only for essential details, but also enforce stronger security with mobile verification.
 
 In this flow:
 
@@ -22,7 +22,7 @@ This ensures that every registered user has a valid mobile number, reducing the
 
 ![Final Flow]({{base_path}}/assets/img/guides/flows/flow-builder-registration-final-flow.png){: width="auto" style="display: block; margin: 0;"}
 
-## Building the Sample Use Case
+## Build it
 
 This use case is a minimal sign up journey that collects only Email, Mobile, and Password, and requires SMS OTP verification before completing registration. We’ll start from the Basic Details template and modify it as follows:
 
@@ -33,15 +33,15 @@ This use case is a minimal sign up journey that collects only Email, Mobile, and
 
 Follow the steps below to configure it.
 
-### Step 1 – Load the Basic Template
+### Step 1 – Load the basic template
 
-1. Navigate to **Home → Flows**.
-2. Click on the the **Self Registration** card.
+1. Navigate to **Home** > **Flows**.
+2. Click on the **Self Registration** card.
 3. Click the `+` button next to the **Basic Details** template.
 
 ![Step 1]({{base_path}}/assets/img/guides/flows/flow-registration-step-01.gif){: width="auto" style="display: block; margin: 0;"}
 
-### Step 2 – Keep Only Email, Mobile, and Password Fields
+### Step 2 – Keep only email, mobile, and password fields
 
 We can simplify the form to collect only the essentials for registration and ensure that mobile is mandatory for SMS OTP verification later.
 
@@ -55,7 +55,7 @@ We can simplify the form to collect only the essentials for registration and ens
 
 3. Click **Save Draft** to keep your progress.
 
-### Step 3 – Remove the Existing Connection
+### Step 3 – Remove the existing connection
 
 We can now remove the direct link from the sign up button to the success state so we can insert the SMS OTP verification step in between.
 
@@ -64,7 +64,7 @@ We can now remove the direct link from the sign up button to the success state s
 
 ![Step 3]({{base_path}}/assets/img/guides/flows/flow-registration-step-03.gif){: width="auto" style="display: block; margin: 0;"}
 
-### Step 4 – Change Sign Up Button Action to Navigation
+### Step 4 – Change sign up button action to navigation
 
 We should now make the sign up button move the user to the next step (SMS OTP) instead of finalizing the registration immediately.
 
@@ -73,7 +73,7 @@ We should now make the sign up button move the user to the next step (SMS OTP) i
 
 ![Step 4]({{base_path}}/assets/img/guides/flows/flow-registration-step-04.gif){: width="auto" style="display: block; margin: 0;"}
 
-### Step 5 – Add an SMS OTP Verification Step
+### Step 5 – Add an SMS OTP verification step
 
 This step verifies the mobile number provided during sign up before completing account creation.
 

Original file line number	Diff line number	Diff line change
`@@ -0,0 +1 @@`
	`1`	`+{% include "../../../../../includes/guides/flows/invited-user-registration.md" %}`