diff --git a/docs/plugins/hooks.rst b/docs/plugins/hooks.rst
index f560bf6e0a..eb64dd8bca 100644
--- a/docs/plugins/hooks.rst
+++ b/docs/plugins/hooks.rst
@@ -182,4 +182,12 @@ Executed whenever a post is created or edited, after it is saved into the databa
 
 ``action:user.set``
 ^^^^^^^^^^^^^^^^^^^^^
-Useful for things like awarding badges or achievements after a user has reached some value (ex. 100 posts)
\ No newline at end of file
+Parameters: field (str), value, type ('set', 'increment', or 'decrement')
+Useful for things like awarding badges or achievements after a user has reached some value (ex. 100 posts)
+
+``action:settings.set``
+^^^^^^^^^^^^^^^^^^^^^
+Parameters: hash (str), object (obj)
+Useful if your plugins want to cache settings instead of pulling from DB everytime a method is called. Listen to this and refresh accordingly.
+
+