wso2 · himeshsiriwardana · Jan 24, 2025 · Dec 10, 2024 · Jan 21, 2025 · Jan 16, 2025
diff --git a/en/asgardeo/docs/assets/img/guides/branding/select-sms-template.png b/en/asgardeo/docs/assets/img/guides/branding/select-sms-template.png
diff --git a/en/asgardeo/docs/guides/branding/customize-sms-templates.md b/en/asgardeo/docs/guides/branding/customize-sms-templates.md
@@ -0,0 +1,7 @@
+{% set product_name = "Asgardeo" %}
+
+{% set notification_templates_api_path = "notification-templates-rest-api" %}
+
+{% set localization_doc_path = "localization" %}
+
+{% include "../../../../includes/guides/branding/customize-sms-templates.md" %}
diff --git a/en/asgardeo/mkdocs.yml b/en/asgardeo/mkdocs.yml
@@ -366,6 +366,7 @@ nav:
             - Branding AI: guides/branding/ai-branding.md
             - Configure custom domains: guides/branding/configure-custom-domains.md
             - Customize email templates: guides/branding/customize-email-templates.md
+            - Customize SMS templates: guides/branding/customize-sms-templates.md
             - Localization in Asgardeo: guides/branding/localization.md
         - Extend with actions:
             - Understanding actions: guides/customize/actions/understanding-actions.md

diff --git a/en/identity-server/next/docs/assets/img/guides/branding/select-sms-template.png b/en/identity-server/next/docs/assets/img/guides/branding/select-sms-template.png
diff --git a/en/identity-server/next/docs/guides/branding/customize-sms-templates.md b/en/identity-server/next/docs/guides/branding/customize-sms-templates.md
@@ -0,0 +1,7 @@
+{% set product_name = "WSO2 Identity Server" %}
+
+{% set notification_templates_api_path = "notification-templates-rest-api" %}
+
+{% set localization_doc_path = "localization" %}
+
+{% include "../../../../../includes/guides/branding/customize-sms-templates.md" %}
diff --git a/en/identity-server/next/mkdocs.yml b/en/identity-server/next/mkdocs.yml
@@ -607,6 +607,7 @@ nav:
             - Configure UI branding: guides/branding/configure-ui-branding.md
             - Customize layouts: guides/branding/add-custom-layouts.md
             - Customize email templates: guides/branding/customize-email-templates.md
+            - Customize SMS templates: guides/branding/customize-sms-templates.md
             - Localization support: guides/branding/localization.md
           - Extend with actions:
             - Understanding actions: guides/customize/actions/understanding-actions.md

diff --git a/en/includes/guides/branding/customize-email-templates.md b/en/includes/guides/branding/customize-email-templates.md
@@ -95,13 +95,13 @@ You can tailor the **subject**, **body**, and **footer** of email notifications
 !!! warning "Apply changes to user profiles"
     To apply these changes to each user's profile in your organization:
 
-    1. Display the `local` attribute on the user's profile. Learn more on [updating user attributes]({{base_path}}/guides/users/attributes/manage-attributes/#update-attributes).
+    1. Display the `local` attribute on the user's profile. Learn how to do so in [updating user attributes]({{base_path}}/guides/users/attributes/manage-attributes/#update-attributes).
 
-    2. Update the `local` attribute value with the [required locale code]({{base_path}}/guides/branding/{{ localization_doc_path }}/#supported-languages).
+    2. Update the `local` attribute value with the [required locale code]({{base_path}}/guides/branding/{{ localization_doc_path }}/#supported-languages). The value should be updated by,
 
-        - If the admin onboards the user to the organization, the admin is responsible for updating the locale code.
+        - the admin, if the admin onboards the user to the organization.
 
-        - If the user self-registers, they should update the locale code by themselves at the time of registration.
+        - the user, if the user self-registers to the organization.
 
 Alternatively, you can customize the content of email templates using the [Email Templates API]({{base_path}}/apis/{{ email_templates_api_path }}/) provided by {{ product_name }}.
 

diff --git a/en/includes/guides/branding/customize-sms-templates.md b/en/includes/guides/branding/customize-sms-templates.md
@@ -0,0 +1,32 @@
+# Customize SMS templates
+
+The following topics explain how you can customize SMS notifications that are sent to users of your {{ product_name }} organization.
+
+## Customize SMS content
+
+You can tailor the **body** of SMS notifications to your preferences by following the steps below.
+
+!!! note
+    This feature is only available for the most frequently used SMS templates. You can customize [all available SMS templates]({{base_path}}/references/sms-templates/) using the [Notification Templates API]({{base_path}}/apis/{{ notificaiton_templates_api_path }}/).
+
+1. On the {{ product_name }}, go to **Branding** > **SMS Templates**.
+2. Select the SMS template and the relevant locale that you wish to modify.
+
+    ![Select SMS template]({{base_path}}/assets/img/guides/branding/select-sms-template.png){: width="600" style="display: block; margin: 0; border: 0.3px solid lightgrey;"}
+
+3. Make your modifications in the **SMS Template Body** input field and use the **Preview** for a real-time preview.
+
+4. Click **Save** to publish your changes.
+
+!!! warning "Apply changes to user profiles"
+    To apply these changes to each user's profile in your organization:
+
+    1. Display the `local` attribute on the user's profile. Learn how to do so in [updating user attributes]({{base_path}}/guides/users/attributes/manage-attributes/#update-attributes).
+
+    2. Update the `local` attribute value with the [required locale code]({{base_path}}/guides/branding/{{ localization_doc_path }}/#supported-languages). The value should be updated by,
+
+        - the admin, if the admin onboards the user to the organization.
+
+        - the user, if the user self-registers to the organization.
+
+Alternatively, you can customize the content of SMS templates using the [Notification Templates API]({{base_path}}/apis/{{ notification_templates_api_path }}/) provided by {{ product_name }}.