diff --git a/book/aliases.md b/book/aliases.md
index b6f2b0c5f27..ff0c57bcb0a 100644
--- a/book/aliases.md
+++ b/book/aliases.md
@@ -29,6 +29,17 @@ Your useable aliases can be seen in `$nu.scope.aliases`.
 ## Persisting
 
 To make your aliases persistent they must be added to your _config.nu_ file by running `config nu` to open an editor and inserting them, and then restarting nushell.
+e.g. with the above `ll` alias, you can add `alias ll = ls -l` anywhere in _config.nu_
+
+```nushell
+$env.config = {
+    # main configuration
+}
+
+alias ll = ls -l
+
+# some other config and script loading
+```
 
 ## Piping in aliases