diff --git a/README.md b/README.md
index 0fd60bf..28c9b52 100644
--- a/README.md
+++ b/README.md
@@ -10,7 +10,10 @@ in any game mode world.
 4. Edit the config.yml how you want.
 5. Restart the server if you make a change
 
-## Config.yml
+## Commands
+There is a user command and an admin command called "limits". Admins can check the limits of a specific island owner. Both show a GUI panel with the limits and the current count.
+
+## Setup - Config.yml
 
 The config.yml has the following sections:
 
@@ -28,4 +31,27 @@ This section lists block limits for specific worlds. You must name the world spe
 
 ### entitylimits
 
-Coming soon!
\ No newline at end of file
+Coming soon!
+
+## Permissions
+
+Island owners can have exclusive permissions that override the default or world settings. The format is:
+
+Format is `GAME-MODE-NAME.island.limit.MATERIAL.LIMIT`
+
+example: `bskyblock.island.limit.hopper.10`
+
+Permissions activate when the player logs in.
+
+Usage permissions are:
+
+```
+  limits.player.limits:
+    description: Player can use limits command
+    default: true
+  limits.admin.limits:
+    description: Player can use admin limits command
+    default: op
+```
+
+