diff --git a/tinywiki/migrations/pages/bbcode.bbcode b/tinywiki/migrations/pages/bbcode.bbcode
index c8afde0..3758be3 100644
--- a/tinywiki/migrations/pages/bbcode.bbcode
+++ b/tinywiki/migrations/pages/bbcode.bbcode
@@ -127,7 +127,7 @@ An unordered list:
 [ul]
 [li] Item 1[/li]
 [li] Item 2[/li]
-[li] 
+[li]
     [ul]
     [li]Embedded 1[/li]
     [li]Embedded 2[/li]
@@ -139,7 +139,7 @@ An ordered list:
 [ol]
 [li] Item 1[/li]
 [li] Item 2[/li]
-[li] 
+[li]
     [ol]
     [li] Embedded 1[/li]
     [li]Embedded 2[/li]
@@ -159,7 +159,7 @@ An unordered list:
 [ul]
 [li] Item 1[/li]
 [li] Item 2[/li]
-[li] 
+[li]
     [ul]
     [li]Embedded 1[/li]
     [li]Embedded 2[/li]
@@ -171,7 +171,7 @@ An ordered list:
 [ol]
 [li] Item 1[/li]
 [li] Item 2[/li]
-[li] 
+[li]
     [ol]
     [li]Embedded 1[/li]
     [li]Embedded 2[/li]
@@ -579,4 +579,76 @@ You can also create tables that span over mutliple rows or columns. Add the [cod
     [/tr]
 [/table]
 
-[h2]Images[/h2]
\ No newline at end of file
+[h2]Images[/h2]
+
+[p]
+To embed images, use the [code][img=url]description[/img][/code] or the [code][image=url]description[/image][/code] tag. For Uploaded images use the [code][wiki-image=slug][/code] or the [code][wimg=slug][/code] tag.
+[/p]
+[p]
+You can also resize your image by using the [code]width[/code] and [code]height[/code] arguments.
+The accepted values are: [code]width=25[/code], [code]width=50[/code], [code]width=75[/code] and [code]width=100[width] for generic resizing. You can also set the width and height in [i]%[/i]([code]width=32%[/code]), in [i]em[/i] ([code]width=5em[/code] and [i]rem[/i] ([code]width=20rem[/code]).
+[/p]
+[p]
+To align images you can use the [code]postion[/code] argument. Accepted values for positioning are [code]left[/code] or [code]start[/code], [code]center[/code] and [code]right[/code] or [code]end[/code].
+[/p]
+[p]
+When the embeded images don't fill up the whole width, the text floats around them.
+[/p]
+
+[codeblock]
+[img="https://images.unsplash.com/photo-1764957080687-9569e738a238?q=80&w=1740&auto=format&fit=crop&ixlib=rb-4.1.0&ixid=M3wxMjA3fDB8MHxwaG90by1wYWdlfHx8fGVufDB8fHx8fA%3D%3D"]
+Image from [url=https://beckerworks.de]David Becker[/url]
+on [url=https://unsplash.com]Unsplash.com[/url]
+[/img]
+
+[wiki-image=tw-image-01]
+
+[wimg=tw-image-01 width=25 position=left]
+[wimg=tw-image-01 width=25 position=right]
+[wimg=tw-image-01 width=25 position=center]
+
+[wimg=tw-image-01 width=25 position=left]
+[h3]Some example text[/h3]
+[p]
+Lorem ipsum dolor sit amet, consetetur sadipscing elitr, sed diam nonumy eirmod
+tempor invidunt ut labore et dolore magna aliquyam erat, sed diam voluptua.
+At vero eos et accusam et justo duo dolores et ea rebum. Stet clita kasd gubergren,
+no sea takimata sanctus est Lorem ipsum dolor sit amet. Lorem ipsum dolor sit
+amet, consetetur sadipscing elitr, sed diam nonumy eirmod tempor invidunt ut
+labore et dolore magna aliquyam erat, sed diam voluptua. At vero eos et accusam et
+justo duo dolores et ea rebum. Stet clita kasd gubergren, no sea takimata sanctus
+est Lorem ipsum dolor sit amet. Lorem ipsum dolor sit amet, consetetur sadipscing
+elitr, sed diam nonumy eirmod tempor invidunt ut labore et dolore magna aliquyam
+erat, sed diam voluptua. At vero eos et accusam et justo duo dolores et ea rebum.
+Stet clita kasd gubergren, no sea takimata sanctus est Lorem ipsum dolor sit amet.
+[/p]
+[hr][/codeblock]
+
+[img="https://images.unsplash.com/photo-1764957080687-9569e738a238?q=80&w=1740&auto=format&fit=crop&ixlib=rb-4.1.0&ixid=M3wxMjA3fDB8MHxwaG90by1wYWdlfHx8fGVufDB8fHx8fA%3D%3D"]
+Image from [url=https://beckerworks.de]David Becker[/url] on [url=https://unsplash.com]Unsplash.com[/url]
+[/img]
+
+[wiki-image=tw-image-01]
+
+[wimg=tw-image-01 width=25 position=left]
+[wimg=tw-image-01 width=25 position=right]
+[wimg=tw-image-01 width=25 position=center]
+
+[hr]
+
+[wimg=tw-image-01 width=50 position=left]
+[h3]Some example text[/h3]
+[p]
+Lorem ipsum dolor sit amet, consetetur sadipscing elitr, sed diam nonumy eirmod
+tempor invidunt ut labore et dolore magna aliquyam erat, sed diam voluptua.
+At vero eos et accusam et justo duo dolores et ea rebum. Stet clita kasd gubergren,
+no sea takimata sanctus est Lorem ipsum dolor sit amet. Lorem ipsum dolor sit
+amet, consetetur sadipscing elitr, sed diam nonumy eirmod tempor invidunt ut
+labore et dolore magna aliquyam erat, sed diam voluptua. At vero eos et accusam et
+justo duo dolores et ea rebum. Stet clita kasd gubergren, no sea takimata sanctus
+est Lorem ipsum dolor sit amet. Lorem ipsum dolor sit amet, consetetur sadipscing
+elitr, sed diam nonumy eirmod tempor invidunt ut labore et dolore magna aliquyam
+erat, sed diam voluptua. At vero eos et accusam et justo duo dolores et ea rebum.
+Stet clita kasd gubergren, no sea takimata sanctus est Lorem ipsum dolor sit amet.
+[/p]
+[hr]
\ No newline at end of file