diff --git a/subprojects/gst-docs/meson.build b/subprojects/gst-docs/meson.build
index b38be12ea6..308d7f51c4 100644
--- a/subprojects/gst-docs/meson.build
+++ b/subprojects/gst-docs/meson.build
@@ -124,6 +124,7 @@ gstreamer_doc = hotdoc.generate_doc('GStreamer',
     build_always_stale: true,
     edit_on_github_repository: 'https://gitlab.freedesktop.org/gstreamer/gst-docs/',
     previous_symbol_index: join_paths(meson.current_source_dir(), 'symbols', 'symbol_index.json'),
+    fatal_warning: get_option('fatal_warnings')
 )
 
 cdata = configuration_data()
diff --git a/subprojects/gst-docs/meson_options.txt b/subprojects/gst-docs/meson_options.txt
index 06f5ecf7ba..37e1280747 100644
--- a/subprojects/gst-docs/meson_options.txt
+++ b/subprojects/gst-docs/meson_options.txt
@@ -4,3 +4,4 @@ option('built_subprojects', type : 'string', value : '')
 # Special entry to make `gst-docs` usable as part of a bigger
 # portal (gnome-portal for example).
 option('use_portal_index', type : 'boolean', value : true)
+option('fatal_warnings', type : 'boolean', value : false)