diff --git a/docs/configuring-playbook-client-element-web.md b/docs/configuring-playbook-client-element-web.md
index 0656c93fa..21ab26591 100644
--- a/docs/configuring-playbook-client-element-web.md
+++ b/docs/configuring-playbook-client-element-web.md
@@ -17,11 +17,19 @@ When setting, replace `example.com` with your own.
 
 ## Adjusting the playbook configuration
 
+### Set the country code for phone number inputs
+
+You can change the country code (default: `GB`) to use when showing phone number inputs. To change it to `FR` for example, add the following configuration to your `inventory/host_vars/matrix.example.com/vars.yml` file:
+
+```yaml
+matrix_client_element_default_country_code: "FR"
+```
+
 ### Themes
 
 #### Change the default theme
 
-You can change the default theme from `light` to `dark`. To do so, add the following configuration to your `inventory/host_vars/matrix.example.com/vars.yml` file:
+You can change the default theme from `light` to `dark`. To do so, add the following configuration to your `vars.yml` file:
 
 ```yaml
 # Controls the default theme
diff --git a/docs/configuring-playbook-client-schildichat-web.md b/docs/configuring-playbook-client-schildichat-web.md
index 147d8056e..9c2f1eba4 100644
--- a/docs/configuring-playbook-client-schildichat-web.md
+++ b/docs/configuring-playbook-client-schildichat-web.md
@@ -22,11 +22,19 @@ To enable SchildiChat Web, add the following configuration to your `inventory/ho
 matrix_client_schildichat_enabled: true
 ```
 
+### Set the country code for phone number inputs
+
+You can change the country code (default: `GB`) to use when showing phone number inputs. To change it to `FR` for example, add the following configuration to your `inventory/host_vars/matrix.example.com/vars.yml` file:
+
+```yaml
+matrix_client_schildichat_default_country_code: "FR"
+```
+
 ### Themes
 
 #### Change the default theme
 
-You can change the default theme from `light` to `dark`. To do so, add the following configuration to your `inventory/host_vars/matrix.example.com/vars.yml` file:
+You can change the default theme from `light` to `dark`. To do so, add the following configuration to your `vars.yml` file:
 
 ```yaml
 # Controls the default theme
diff --git a/roles/custom/matrix-client-element/defaults/main.yml b/roles/custom/matrix-client-element/defaults/main.yml
index 863c14910..c970b3f38 100644
--- a/roles/custom/matrix-client-element/defaults/main.yml
+++ b/roles/custom/matrix-client-element/defaults/main.yml
@@ -194,7 +194,7 @@ matrix_client_element_self_check_validate_certificates: true
 # don't show the registration button on welcome page
 matrix_client_element_registration_enabled: false
 
-# Default country code on welcome page when login by phone number
+# An optional ISO 3166 alpha2 country code (eg: GB, the default) to use when showing phone number inputs
 matrix_client_element_default_country_code: "GB"
 
 # Controls whether presence will be enabled
diff --git a/roles/custom/matrix-client-schildichat/defaults/main.yml b/roles/custom/matrix-client-schildichat/defaults/main.yml
index 68f0e86b9..8d170e4e3 100644
--- a/roles/custom/matrix-client-schildichat/defaults/main.yml
+++ b/roles/custom/matrix-client-schildichat/defaults/main.yml
@@ -189,7 +189,7 @@ matrix_client_schildichat_self_check_validate_certificates: true
 # don't show the registration button on welcome page
 matrix_client_schildichat_registration_enabled: false
 
-# Default country code on welcome page when login by phone number
+# An optional ISO 3166 alpha2 country code (eg: GB, the default) to use when showing phone number inputs
 matrix_client_schildichat_default_country_code: "GB"
 
 # Controls whether presence will be enabled