diff --git a/Custom-text-replaces.md b/Custom-text-replaces.md
new file mode 100644
index 0000000..0e04038
--- /dev/null
+++ b/Custom-text-replaces.md
@@ -0,0 +1,38 @@
+**Custom text replaces** is the JSON settings feature that allows you to set your own text replaces, such as `:shrug:` to `¯\_(ツ)_/¯`. Feature has been added in Kotatogram 1.1.6.
+
+> **Note:** this feature works only when "Replace emoji" option is enabled (Settings > Chat Settings). An option to disable only default replaces but not custom, is considered but not done yet.
+
+## How to use this option
+Add or find "replaces" option, it should be an array. To add a replace, you should add a subarray, where first item is text that you are typing, and second is the result of replacement.
+
+## Examples
+
+### Empty example
+```json
+{
+  "replaces": []
+}
+```
+
+### One replacement
+This will add replacement from `start` to `starting`.
+
+```json
+{
+  "replaces": [
+    ["start", "starting"]
+  ]
+}
+```
+
+### Two replacements
+This will add replacement from `pot` to `potato`, and from `cat` to `cotato`.
+
+```json
+{
+  "replaces": [
+    ["pot", "potato"],
+    ["cat", "cotato"]
+  ]
+}
+```
\ No newline at end of file