diff --git a/docs/non-normative/db-migration.md b/docs/non-normative/db-migration.md
index 596a665a2..bd6d2039b 100644
--- a/docs/non-normative/db-migration.md
+++ b/docs/non-normative/db-migration.md
@@ -22,6 +22,10 @@ updated to the stable database semantic conventions, they:
 - May drop the environment variable in their next major version and emit only
   the stable database conventions.
 
+> [!NOTE]
+> `OTEL_SEMCONV_STABILITY_OPT_IN` is only intended to be used when migrating
+> from an experimental semantic convention to its initial stable version.
+
 ## Summary of changes
 
 This section summarizes the changes made to the HTTP semantic conventions
diff --git a/docs/non-normative/http-migration.md b/docs/non-normative/http-migration.md
index d0c70fe68..959648b76 100644
--- a/docs/non-normative/http-migration.md
+++ b/docs/non-normative/http-migration.md
@@ -29,6 +29,10 @@ updated to the stable HTTP semantic conventions, they:
 - May drop the environment variable in their next major version and emit only
   the stable HTTP and networking conventions.
 
+> [!NOTE]
+> `OTEL_SEMCONV_STABILITY_OPT_IN` is only intended to be used when migrating
+> from an experimental semantic convention to its initial stable version.
+
 ## Summary of changes
 
 This section summarizes the changes made to the HTTP semantic conventions