diff --git a/doc/en/block-properties.md b/doc/en/block-properties.md
index 18c068ca..fb874e0c 100644
--- a/doc/en/block-properties.md
+++ b/doc/en/block-properties.md
@@ -187,3 +187,12 @@ Available data types:
 - Currently, the total sum of the field sizes cannot exceed 240 bytes.
 - A field without an array length specification is equivalent to an array of 1 element.
 - A character array can be used to store UTF-8 strings.
+
+## User properties
+
+User properties must be declared in `pack:config/user-props.toml` file:
+```toml
+"pack:property_name" = {}
+```
+
+Example: [user properties of pack **base**](../../res/content/base/config/user-props.toml).
diff --git a/doc/ru/block-properties.md b/doc/ru/block-properties.md
index 79b08da2..1862e659 100644
--- a/doc/ru/block-properties.md
+++ b/doc/ru/block-properties.md
@@ -199,3 +199,12 @@
 - На данный момент общая сумма размеров полей не может превышать 240 байт.
 - Поле без указания длины массива эквивалентно массиву из 1 элемента.
 - Массив символьного типа может использоваться для хранения UTF-8 строк.
+
+## Пользовательские свойства
+
+Пользовательские свойства должны быть объявляены в файле `пак:config/user-props.toml`:
+```toml
+"пак:имя_свойства" = {}
+```
+
+Пример: [пользовательские свойства пака **base**](../../res/content/base/config/user-props.toml).