diff --git a/CHANGELOG.md b/CHANGELOG.md
index f93ede62..559c8de6 100644
--- a/CHANGELOG.md
+++ b/CHANGELOG.md
@@ -1,5 +1,9 @@
 # CHANGELOG
 
+## 1.8.0
+- feature: support multi-user environments with new `$multiuser` flag (#89)
+- fix: support for High Sierra
+
 ## 1.7.1
 - fix: include ruby 1.8.3 in metadata.json
 
diff --git a/README.md b/README.md
index 6e9293fb..227c1335 100644
--- a/README.md
+++ b/README.md
@@ -100,6 +100,17 @@ requires the puppet user act as the homebrew user, you may get a password
 prompt on each run. This can be fixed by allowing the puppet user passwordless
 sudo privileges to the homebrew user.
 
+If you are looking for a multi-user installation, please be sure to set the
+multi-user flag, eg.:
+
+```puppet
+class { 'homebrew':
+  user      => 'kevin',
+  group     => 'all-users',
+  multiuser => true,
+}
+```
+
 To install homebrew and a compiler (on Lion or later), eg.:
 
 ```puppet
diff --git a/metadata.json b/metadata.json
index cce76a1d..eb3e0062 100644
--- a/metadata.json
+++ b/metadata.json
@@ -1,6 +1,6 @@
 {
   "name": "thekevjames-homebrew",
-  "version": "1.7.1",
+  "version": "1.8.0",
   "author": "thekevjames",
   "summary": "Homebrew (+brewcask! +taps!) package installer and provider",
   "license": "Apache-2.0",