diff --git a/lib/wibox/layout/align.lua b/lib/wibox/layout/align.lua
index 741d02bf4..642db2a42 100644
--- a/lib/wibox/layout/align.lua
+++ b/lib/wibox/layout/align.lua
@@ -1,4 +1,6 @@
 ---------------------------------------------------------------------------
+--
+--@DOC_wibox_layout_defaults_align_EXAMPLE@
 -- @author Uli Schlachter
 -- @copyright 2010 Uli Schlachter
 -- @release @AWESOME_VERSION@
diff --git a/tests/examples/wibox/layout/defaults/align.lua b/tests/examples/wibox/layout/defaults/align.lua
new file mode 100644
index 000000000..236b5cac5
--- /dev/null
+++ b/tests/examples/wibox/layout/defaults/align.lua
@@ -0,0 +1,10 @@
+local generic_widget = ... --DOC_HIDE
+local wibox     = require("wibox") --DOC_HIDE
+
+return --DOC_HIDE
+wibox.widget {
+    generic_widget( "first"  ),
+    generic_widget( "second" ),
+    generic_widget( "third"  ),
+    layout  = wibox.layout.align.horizontal
+}