diff --git a/developers/utils/i18n.md b/developers/utils/i18n.md
index e4b5deae4..ef98c87f3 100644
--- a/developers/utils/i18n.md
+++ b/developers/utils/i18n.md
@@ -444,6 +444,17 @@ The custom keys are a very good practice to translate bundle dependent error mes
 updateStatus(ThingStatus.OFFLINE, ThingStatusDetail.OFFLINE.COMMUNICATION_ERROR, "@text/offline.communication-error");
 ```
 
+## Generating I18N properties file
+
+To automatically generate an I18N properties file from XML files, the following command can be run:
+
+```shell
+mvn org.openhab.core.tools:i18n-maven-plugin:generate-default-translations
+```
+
+This tool can also be used to update an existing file.
+Custom texts will be preserved when doing this.
+
 ## I18n Text Provider API
 
 To programmatically resolve texts for certain languages openHAB provides the OSGi service `TranslationProvider`.
@@ -478,7 +489,7 @@ For Binding Info and ConfigDescription, the localized objects can be retrieved v
 
 ## Managing translations
 
-Localization is managed with the cloud service [Crowdin](https://crowdin.com/) where translators can contribute translations.
+Localization is managed with the cloud service [Crowdin](https://crowdin.com/) where translators can contribute translations in different languages.
 
 This is the process: