diff --git a/README.md b/README.md
index 8869e6b..41aec9d 100644
--- a/README.md
+++ b/README.md
@@ -1,2 +1,33 @@
 # UtilityBlocks
-ItemsAdder Add-on that adds blueprint-ish blocks to use.
+
+![ia banner][banner]
+
+UtilityBlocks is an ItemsAdder Add-on that implements blueprint-like looking blocks.  
+The focus is to offer creators of add-ons and/or resource packs a way to see their creation at scale with some blocks. Think of it like the Placeholder Development Assets but for Minecraft.
+
+## Download
+
+- Download the `UtilityBlocks-<version>.zip` file from the latest release in the [Releases Tab][releases].
+- Extract the `data` folder from the Zip.
+- Upload the `data` folder to `/plugins/ItemsAdder/` on your server.
+- Run `/iazip` to refresh the resource pack.
+  - Remember to update the download URL if you're not using `self-host` or `auto-external-host`
+
+## License
+
+Project is licensed under MIT.  
+I do allow you to use the textures in your own projects, but please give credit as described by the [LICENSE file][license].
+
+## Preview
+
+![preview 1][preview_1]
+
+![preview 2][preview_2]
+
+<!-- Links -->
+[banner]: https://raw.githubusercontent.com/LoneDev6/Wiki-ItemsAdder/master/.gitbook/assets/ia_addon_banner.png
+
+[releases]: https://github.com/Andre601/UtilityBlocks/releases/latest
+
+[preview_1]: https://raw.githubusercontent.com/Andre601/UtilityBlocks/main/.github/assets/preview_1.png
+[preview_2]: https://raw.githubusercontent.com/Andre601/UtilityBlocks/main/.github/assets/preview_2.png
\ No newline at end of file