diff --git a/docs/libs/codecs/index.md b/docs/libs/codecs/index.md
new file mode 100644
index 0000000000..9e6dd6f3ab
--- /dev/null
+++ b/docs/libs/codecs/index.md
@@ -0,0 +1,3 @@
+# GstCodecs
+
+> NOTE: This library API is considered *unstable*
diff --git a/docs/libs/codecs/sitemap.txt b/docs/libs/codecs/sitemap.txt
new file mode 100644
index 0000000000..4f91fcd8a3
--- /dev/null
+++ b/docs/libs/codecs/sitemap.txt
@@ -0,0 +1 @@
+gi-index
diff --git a/docs/meson.build b/docs/meson.build
index a8f66f279d..465bd81de8 100644
--- a/docs/meson.build
+++ b/docs/meson.build
@@ -104,6 +104,7 @@ if build_gir
         {'name': 'webrtc', 'gir': webrtc_gir, 'lib': gstwebrtc_dep, 'suffix': 'lib'},
         {'name': 'audio', 'gir': audio_gir, 'lib': gstbadaudio_dep, 'prefix': 'bad-'},
         {'name': 'transcoder', 'gir': transcoder_gir, 'lib': gst_transcoder_dep},
+        {'name': 'codecs', 'gir': codecs_gir, 'lib': gstcodecs_dep},
    ]
 endif
 
diff --git a/gst-libs/gst/codecs/gsth264decoder.c b/gst-libs/gst/codecs/gsth264decoder.c
index 26127f5122..a235d745d3 100644
--- a/gst-libs/gst/codecs/gsth264decoder.c
+++ b/gst-libs/gst/codecs/gsth264decoder.c
@@ -46,6 +46,13 @@
  * (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE
  * OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
  */
+/**
+ * SECTION:gsth264decoder
+ * @title: GstH264Decoder
+ * @short_description: Base class to implement stateless H.264 decoders
+ * @sources:
+ * - gsth264picture.h
+ */
 
 #ifdef HAVE_CONFIG_H
 #include <config.h>
diff --git a/gst-libs/gst/codecs/gsth265decoder.c b/gst-libs/gst/codecs/gsth265decoder.c
index 33af638eb6..920336997e 100644
--- a/gst-libs/gst/codecs/gsth265decoder.c
+++ b/gst-libs/gst/codecs/gsth265decoder.c
@@ -18,6 +18,13 @@
  * Free Software Foundation, Inc., 51 Franklin St, Fifth Floor,
  * Boston, MA 02110-1301, USA.
  */
+/**
+ * SECTION:gsth265decoder
+ * @title: GstH265Decoder
+ * @short_description: Base class to implement stateless H.265 decoders
+ * @sources:
+ * - gsth265picture.h
+ */
 
 #ifdef HAVE_CONFIG_H
 #include <config.h>
diff --git a/gst-libs/gst/codecs/gstvp9decoder.c b/gst-libs/gst/codecs/gstvp9decoder.c
index 92ca74e4e0..5d80af503f 100644
--- a/gst-libs/gst/codecs/gstvp9decoder.c
+++ b/gst-libs/gst/codecs/gstvp9decoder.c
@@ -46,6 +46,13 @@
  * (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE
  * OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
  */
+/**
+ * SECTION:gstvp9decoder
+ * @title: Gstvp9Decoder
+ * @short_description: Base class to implement stateless VP9 decoders
+ * @sources:
+ * - gstvp9picture.h
+ */
 
 #ifdef HAVE_CONFIG_H
 #include <config.h>
diff --git a/gst-libs/gst/codecs/meson.build b/gst-libs/gst/codecs/meson.build
index 37d4d10f79..455fafc7ba 100644
--- a/gst-libs/gst/codecs/meson.build
+++ b/gst-libs/gst/codecs/meson.build
@@ -32,6 +32,26 @@ gstcodecs = library('gstcodecs-' + api_version,
   dependencies : [gstvideo_dep, gstcodecparsers_dep],
 )
 
+gen_sources = []
+if build_gir
+  codecs_gir = gnome.generate_gir(gstcodecs,
+    sources : codecs_sources + codecs_headers,
+    namespace : 'GstCodecs',
+    nsversion : api_version,
+    identifier_prefix : 'Gst',
+    symbol_prefix : 'gst',
+    export_packages : 'gstreamer-codecs-1.0',
+    includes : ['Gst-1.0', 'GstVideo-1.0'],
+    install : true,
+    extra_args : gir_init_section + ['-DGST_USE_UNSTABLE_API'] +
+      ['--c-include=gst/codecs/gsth264decoder.h',
+      '--c-include=gst/codecs/gsth265decoder.h',
+      '--c-include=gst/codecs/gstvp9decoder.h', ],
+    dependencies : [gstvideo_dep, gstcodecparsers_dep]
+  )
+endif
+
 gstcodecs_dep = declare_dependency(link_with : gstcodecs,
   include_directories : [libsinc],
+  sources: gen_sources,
   dependencies : [gstvideo_dep, gstcodecparsers_dep])