diff --git a/docs/maps/animations.md b/docs/maps/animations.md
new file mode 100644
index 00000000..276f2332
--- /dev/null
+++ b/docs/maps/animations.md
@@ -0,0 +1,33 @@
+{.section-title.accent.text-primary}
+# Animating WorkAdventure maps
+
+A tile can run an animation in loops, for example to render water or blinking lights. Each animation frame is a single
+32x32 tile. To create an animation, edit the tileset in Tiled and click on the tile to animate (or pick a free tile to
+not overwrite existing ones) and click on the animation editor:
+
+
+
+
+
+
+You can now add all tiles that should be part of the animation via drag and drop to the "playlist" and adjust the frame duration:
+
+
+
+
+ The tile animation editor
+
+
+
+You can preview animations directly in Tiled, using the "Show tile animations" option:
+
+
+
+
+
+ The Show Tile Animations option
+
+
+
+{.alert.alert-info}
+**Tip:** The engine does tile-updates every 100ms, animations with a shorter frame duration will most likely not look that good or may even do not work.
diff --git a/docs/maps/api-ui.md b/docs/maps/api-ui.md
index edda8613..f15de5df 100644
--- a/docs/maps/api-ui.md
+++ b/docs/maps/api-ui.md
@@ -1,5 +1,5 @@
{.section-title.accent.text-primary}
-# API Room functions Reference
+# API UI functions Reference
### Opening a popup
+
+ 
+