diff --git a/pages/osx/defaults.md b/pages/osx/defaults.md
new file mode 100644
index 0000000000..79ad879092
--- /dev/null
+++ b/pages/osx/defaults.md
@@ -0,0 +1,19 @@
+# defaults
+
+> Access OS X user defaults
+
+- read all defaults
+
+`defaults read -app {{app-name}}`
+
+- read specific defaults
+
+`defaults read -app {{app-name}} {{key}}`
+
+- write key value
+
+`defaults write -app {{app-name}} {{key}} {{-type}} {{value}}`
+
+- delete all defaults
+
+`defaults write -app {{app-name}}`
\ No newline at end of file