diff --git a/examples/metadata.yml b/examples/metadata.yml
new file mode 100644
index 0000000..18357ef
--- /dev/null
+++ b/examples/metadata.yml
@@ -0,0 +1,24 @@
+metadata:
+
+  title: test
+  pn: test-01
+  company: some company
+  address: 8888 fancy street west
+
+  authors:
+    created:
+      name: bob ross
+      date: 2023-03-29
+    reviewed:
+      name: n/a
+      date: n/a
+
+  revisions:
+    a:
+      name: bob ross
+      date: 2023-03-29
+      changelog: initial release
+
+  template:
+    name: din-6771
+    sheetsize: A3
diff --git a/src/wireviz/tools/build_examples.py b/src/wireviz/tools/build_examples.py
index 52f7ebc..a95a0c3 100755
--- a/src/wireviz/tools/build_examples.py
+++ b/src/wireviz/tools/build_examples.py
@@ -63,9 +63,16 @@ def build_generated(groupkeys):
             with (path / readme).open("w") as out:
                 out.write(f'# {groups[key]["title"]}\n\n')
         # collect and iterate input YAML files
+
         for yaml_file in collect_filenames("Building", key, input_extensions):
             try:
-                res = cli(["--formats", "ghpst", str(yaml_file)])
+                res = cli([
+                    "--formats",
+                    "ghpst",
+                    str(yaml_file),
+                    "--prepend",
+                    yaml_file.parent / "metadata.yml"
+                ])
             except BaseException as e:
                 if str(e) != "0" and not isinstance(
                     e, (click.ClickException, SystemExit)
diff --git a/tutorial/metadata.yml b/tutorial/metadata.yml
new file mode 100644
index 0000000..e519840
--- /dev/null
+++ b/tutorial/metadata.yml
@@ -0,0 +1,24 @@
+metadata:
+
+  title: test
+  pn: test-01
+  company: some company
+  address: 8888 fancy street west
+
+  authors:
+    created:
+      name: bob ross
+      date: 2023-03-29
+    reviewed:
+      name: n/a
+      date: n/a
+
+  revisions:
+    a:
+      name: bob ross
+      date: 2023-03-29
+      changelog: initial release
+
+  template:
+    name: din-6771
+    sheetsize: A4