diff --git a/README.org b/README.org
index ed7bf90..8f4cc9f 100644
--- a/README.org
+++ b/README.org
@@ -193,6 +193,21 @@ Loading this file is handled automatically on my [[https://git.xenia.me.uk/xenia
   (use-package eshell
     :bind (("C-c t e" . eshell)))
 #+end_src
+
+** Web browser
+#+begin_src emacs-lisp :tangle yes
+  (use-package eww
+    :defer t
+    :diminish
+    :custom
+    (browse-url-browser-function 'eww-browse-url)
+    (browse-url-new-window-flag t)
+    (eww-default-download-directory "~/Downloads/")
+    (eww-auto-rename-buffer 'title)
+    (eww-browse-url-new-window-is-tab nil))
+
+
+#+end_src
 * UI
 #+begin_src emacs-lisp
   (setq use-dialog-box nil