diff --git a/schema.rst b/schema.rst
index c4be839..0db8a3f 100644
--- a/schema.rst
+++ b/schema.rst
@@ -580,6 +580,18 @@ Attribute names are case sensitive.
   may use a symbolic component
   to indicate availability of the feature to users.
 
+.. ----------------------------------------------------------------------------
+.. cps:attribute:: vendor
+  :type: map(any)
+  :context: component configuration package platform
+  :overload:
+
+  Records vendor-specific extensions to CPS metadata. Vendors should ensure the
+  namspace they record in the vendor object is consistent across all scopes.
+
+  Vendors are *strongly* encouraged to record a ``version`` field in the
+  |package| vendor object.
+
 .. ----------------------------------------------------------------------------
 .. cps:attribute:: version
   :type: string
@@ -659,12 +671,6 @@ Notes
 
 - Unless otherwise specified,
   unrecognized attributes shall be ignored.
-  This makes it easier for tools to add tool-specific extensions.
-  (It is *strongly* recommended that the names of any such attributes
-  start with ``x_<tool>_``, where ``<tool>`` is the (lower case) name
-  of the tool which introduced the extension,
-  in order to reduce the chance of conflicts
-  with newer versions of the CPS.)
 
 - The term "CABI", as used throughout,
   refers to (typically C/C++/Fortran) code