diff --git a/Placeholders.md b/Placeholders.md
new file mode 100644
index 0000000..d29e578
--- /dev/null
+++ b/Placeholders.md
@@ -0,0 +1,17 @@
+Placeholders are supported in `text` entries of the config.
+
+## Internal placeholders
+
+`<placeholder:displayname>` - displays player's display name.
+
+`<placeholder:name>` - displays player's actual name.
+
+## PlaceholderAPI placeholders
+
+Plugin configuration supports all PAPI placeholders in `<placeholder:papi_placeholder_without_%>`.
+
+Example:
+
+```yaml
+text: "<placeholder:player_displayname>"
+```
\ No newline at end of file