diff --git a/pages/common/roll.md b/pages/common/roll.md
new file mode 100644
index 000000000..c2885351f
--- /dev/null
+++ b/pages/common/roll.md
@@ -0,0 +1,27 @@
+# roll
+
+> Rolls a user-defined dice sequence.
+
+- Roll 3 6-sided dices and sums the results:
+
+`roll 3d`
+
+- Roll 1 8-sided dice, add 3 and sum the results:
+
+`roll d8 + 3`
+
+- Roll 4 6-sided dices, keep the 3 highest results and sum the results:
+
+`roll 4d6h3`
+
+- Roll 2 12-sided dices 2 times and show every roll:
+
+`roll --verbose 2{2d12}`
+
+- Roll 2 20-sided dices until the result is bigger than 10:
+
+`roll "2d20>10"`
+
+- Roll 2 5-sided dices 3 times and show the total sum:
+
+`roll --sum-series 3{2d5}`