diff --git a/pages/common/join.md b/pages/common/join.md
new file mode 100644
index 0000000000..1af8b9e987
--- /dev/null
+++ b/pages/common/join.md
@@ -0,0 +1,15 @@
+# join
+
+> Join lines of two sorted files on a common field.
+
+- Join two files on the first (default) field:
+
+`join {{file1}} {{file2}}`
+
+- Join field3 of file1 with field1 of file2:
+
+`join -1 3 -2 1 {{file1}} {{file2}}`
+
+- Produce a line for each unpairable line for file1:
+
+`join -a 1 {{file1}} {{file2}}`