diff --git a/doc/global/macros-online.qdocconf b/doc/global/macros-online.qdocconf
index bfc2f98a12c..dafbabff4d2 100644
--- a/doc/global/macros-online.qdocconf
+++ b/doc/global/macros-online.qdocconf
@@ -2,5 +2,11 @@ macro.youtube.HTML = "<div class=\"video\">\n<span class=\"vspan\"></span>\n" \
                      "<iframe src=\"https://www.youtube.com/embed/\1\"" \
                      "frameborder=\"0\" allowfullscreen>\n" \
                      "</iframe></div>\n"
+macro.youtube.DocBook = "<db:mediaobject>\n" \
+                        "<db:videoobject>\n" \
+                        "<db:videodata fileref=\"\1\">\n" \
+                        "</db:videodata>\n" \
+                        "</db:videoobject>\n" \
+                        "</db:mediaobject>\n"
 
 include(htmltabs.qdocconf)
diff --git a/doc/global/macros.qdocconf b/doc/global/macros.qdocconf
index 6c64abee93b..7bd00a15105 100644
--- a/doc/global/macros.qdocconf
+++ b/doc/global/macros.qdocconf
@@ -90,6 +90,16 @@ macro.youtube.HTML = "<div class=\"video\">\n" \
                      "<img src=\"images/\1.jpg\"" \
                      "title=\"Click to play in a browser\" /></a>\n" \
                      "</div>\n"
+macro.youtube.DocBook = "<db:mediaobject>\n" \
+                        "<db:videoobject>\n" \
+                        "<db:videodata fileref=\"\1\">\n" \
+                        "</db:videodata>\n" \
+                        "</db:videoobject>\n" \
+                        "<db:imageobject>\n" \
+                        "<db:imagedata fileref=\"images/\1.jpg\">\n" \
+                        "</db:imagedata>\n" \
+                        "</db:imageobject>\n" \
+                        "</db:mediaobject>\n"
 
 macro.excludefromcreator = "\\meta tag broken"