diff --git a/docs/commands/shuffle.md b/docs/commands/shuffle.md
new file mode 100644
index 0000000000..531dc07dab
--- /dev/null
+++ b/docs/commands/shuffle.md
@@ -0,0 +1,33 @@
+# shuffle
+
+Shuffles the rows in a random order.
+
+## Examples - 
+
+Passing the same input to shuffle multiple times gives different results - 
+
+```
+❯ echo [ a b c d ]  | shuffle 
+───┬───
+ 0 │ a 
+ 1 │ c 
+ 2 │ d 
+ 3 │ b 
+───┴───
+
+❯ echo [ a b c d ]  | shuffle 
+───┬───
+ 0 │ c 
+ 1 │ b 
+ 2 │ d 
+ 3 │ a 
+───┴───
+
+❯ echo [ a b c d ]  | shuffle 
+───┬───
+ 0 │ c 
+ 1 │ b 
+ 2 │ a 
+ 3 │ d 
+───┴───
+```