diff --git a/docs/.vitepress/config.mts b/docs/.vitepress/config.mts
index 4b913cb..c9eec7f 100644
--- a/docs/.vitepress/config.mts
+++ b/docs/.vitepress/config.mts
@@ -140,6 +140,7 @@ export default defineConfig({
             {text: 'Debug', link: 'references/plugins/debug'},
             {text: 'Reactive', link: 'references/plugins/reactive'},
             {text: 'State', link: 'references/plugins/state'},
+            {text: 'Text Wrapping', link: 'references/plugins/textWrapping'},
             {text: 'Theme', link: 'references/plugins/theme'},
             {text: 'Xml', link: 'references/plugins/xml'},
           ]
diff --git a/docs/guides/textWrapping.md b/docs/guides/textWrapping.md
new file mode 100644
index 0000000..354b8cb
--- /dev/null
+++ b/docs/guides/textWrapping.md
@@ -0,0 +1,28 @@
+# Text Wrapping
+
+Labels in Basalt provide automatic text wrapping functionality. By default, a label adjusts its width to fit the text content. However, you can control this behavior to make the text wrap instead.
+
+## Basic Usage
+```lua
+local main = basalt.createFrame()
+local label = main:addLabel()
+    :setSize(20, 5)     -- Set fixed width
+    :setAutoSize(false) -- Disable auto-sizing
+    :setText("This is a long text that will automatically wrap to fit the label's width")
+```
+
+## Understanding Auto-Size
+- Default behavior: Label width grows to fit text
+- With `:setAutoSize(false)`: Text wraps to fit label width
+- Text wrapping only works when auto-size is disabled
+
+## Examples
+```lua
+-- Default: Label grows with text
+label:setText("Long text...")  -- Width adjusts automatically
+
+-- Fixed width with wrapping
+label:setSize(15, 5)
+    :setAutoSize(false)       -- Enable text wrapping
+    :setText("Text wraps to fit 15 characters width")
+```