diff --git a/README.org b/README.org
index 676dc0e16..5dd16e0ab 100644
--- a/README.org
+++ b/README.org
@@ -91,6 +91,17 @@ required in a user's config via =use-package= or =leaf=.
         # config = ./emacs.org;
         config = ./emacs.el;
 
+        # Whether to include your config as a default init file.
+        # If being bool, the value of config is used.
+        # Its value can also be a derivation like this if you want to do some
+        # substitution:
+        #   defaultInitFile = pkgs.substituteAll {
+        #     name = "default.el";
+        #     src = ./emacs.el;
+        #     inherit (config.xdg) configHome dataHome;
+        #   };
+        defaultInitFile = true;
+
         # Package is optional, defaults to pkgs.emacs
         package = pkgs.emacsGit;