diff --git a/apps/docs/docs/guides/multi-avatars.mdx b/apps/docs/docs/guides/multi-avatars.mdx
new file mode 100644
index 000000000..d56b07992
--- /dev/null
+++ b/apps/docs/docs/guides/multi-avatars.mdx
@@ -0,0 +1,27 @@
+# Dynamic avatars
+
+You can decide to change the host avatar dynamically so that your bot can display multiple avatars. Here is a simple example:
+
+<img
+  src="/img/guides/multi-avatars/demo.gif"
+  width="800"
+  alt="Multiple avatars demo"
+/>
+
+For this, head over to the "Theme" tab and set the host avatar to a variable URL:
+
+<img
+  src="/img/guides/multi-avatars/bot-variable.png"
+  width="500"
+  alt="Variable URL bot"
+/>
+
+Then you can set this variable to any URL in your flow so that the host avatar changes dynamically.
+
+<img
+  src="/img/guides/multi-avatars/flow-example.png"
+  width="800"
+  alt="Multiple avatars flow example"
+/>
+
+The first block defines all the avatars that can be displayed. The second block starts by setting the avatar to the wizard avatar. The final block starts by setting the swordsmith avatar.
diff --git a/apps/docs/static/img/guides/multi-avatars/bot-variable.png b/apps/docs/static/img/guides/multi-avatars/bot-variable.png
new file mode 100644
index 000000000..c7445122c
Binary files /dev/null and b/apps/docs/static/img/guides/multi-avatars/bot-variable.png differ
diff --git a/apps/docs/static/img/guides/multi-avatars/demo.gif b/apps/docs/static/img/guides/multi-avatars/demo.gif
new file mode 100644
index 000000000..9675d0480
Binary files /dev/null and b/apps/docs/static/img/guides/multi-avatars/demo.gif differ
diff --git a/apps/docs/static/img/guides/multi-avatars/flow-example.png b/apps/docs/static/img/guides/multi-avatars/flow-example.png
new file mode 100644
index 000000000..d5ac8efc4
Binary files /dev/null and b/apps/docs/static/img/guides/multi-avatars/flow-example.png differ