diff --git a/versions/3.1.0.md b/versions/3.1.0.md
index 58d354f3fc..7d915f8b5e 100644
--- a/versions/3.1.0.md
+++ b/versions/3.1.0.md
@@ -2686,6 +2686,8 @@ Field Name | Type | Description
propertyName | `string` | **REQUIRED**. The name of the property in the payload that will hold the discriminator value.
mapping | Map[`string`, `string`] | An object to hold mappings between payload values and schema names or references.
+This object MAY be extended with [Specification Extensions](#specificationExtensions).
+
The discriminator object is legal only when using one of the composite keywords `oneOf`, `anyOf`, `allOf`.
In OAS 3.0, a response payload MAY be described to be exactly one of any number of types: