diff --git a/man/os-release.xml b/man/os-release.xml
index 113ef9fc18a..e74f27b9907 100644
--- a/man/os-release.xml
+++ b/man/os-release.xml
@@ -111,6 +111,11 @@
VERSION_ID= exists and matches. This ensures ABI/API compatibility between the
layers and prevents merging of an incompatible image in an overlay.
+ In order to identify the extension image itself, the same fields defined below can be added to the
+ extension-release file with a SYSEXT_ prefix (to disambiguate
+ from fields used to match on the base image). E.g.: SYSEXT_ID=myext,
+ SYSEXT_VERSION_ID=1.2.3.
+
In the extension-release.IMAGE filename, the
IMAGE part must exactly match the file name of the containing image with the
suffix removed. In case it is not possible to guarantee that an image file name is stable and doesn't