diff --git a/adcom1/app.go b/adcom1/app.go
index e49f001..57d2ac3 100644
--- a/adcom1/app.go
+++ b/adcom1/app.go
@@ -59,9 +59,11 @@ type App struct {
 	// Attribute:
 	//   keywords
 	// Type:
-	//   string
+	//   string; DEPRECATED
 	// Definition:
-	//   Comma separated list of keywords about the app.
+	//   Comma-separated list of keywords about the app.
+	//   Only one of 'keywords' or 'kwarray' may be present.
+	//   NOTE: this field is deprecated, use 'kwarray' instead.
 	Keywords string `json:"keywords,omitempty"`
 
 	// Attribute:
diff --git a/adcom1/content.go b/adcom1/content.go
index fc06ef7..a7ef9b3 100644
--- a/adcom1/content.go
+++ b/adcom1/content.go
@@ -153,9 +153,11 @@ type Content struct {
 	// Attribute:
 	//   keywords
 	// Type:
-	//   string
+	//   string; DEPRECATED
 	// Definition:
-	//   Comma separated list of keywords describing the content.
+	//   Comma-separated list of keywords describing the content.
+	//   Only one of 'keywords' or 'kwarray' may be present.
+	//   NOTE: this field is deprecated, use 'kwarray' instead.
 	Keywords string `json:"keywords,omitempty"`
 
 	// Attribute:
diff --git a/adcom1/site.go b/adcom1/site.go
index e7f0eba..f7e5f62 100644
--- a/adcom1/site.go
+++ b/adcom1/site.go
@@ -59,9 +59,11 @@ type Site struct {
 	// Attribute:
 	//   keywords
 	// Type:
-	//   string
+	//   string; DEPRECATED
 	// Definition:
-	//   Comma separated list of keywords about the site.
+	//   Comma-separated list of keywords about the app.
+	//   Only one of 'keywords' or 'kwarray' may be present.
+	//   NOTE: this field is deprecated, use 'kwarray' instead.
 	Keywords string `json:"keywords,omitempty"`
 
 	// Attribute:
diff --git a/adcom1/user.go b/adcom1/user.go
index 197605a..38ab2ec 100644
--- a/adcom1/user.go
+++ b/adcom1/user.go
@@ -43,9 +43,11 @@ type User struct {
 	// Attribute:
 	//   keywords
 	// Type:
-	//   string
+	//   string; DEPRECATED
 	// Definition:
-	//   Comma separated list of keywords, interests, or intent.
+	//   Comma-separated list of keywords, interests, or intent.
+	//   Only one of 'keywords' or 'kwarray' may be present.
+	//   NOTE: this field is deprecated, use 'kwarray' instead.
 	Keywords string `json:"keywords,omitempty"`
 
 	// Attribute:
diff --git a/openrtb2/app.go b/openrtb2/app.go
index 502d608..dc6f9a4 100644
--- a/openrtb2/app.go
+++ b/openrtb2/app.go
@@ -138,7 +138,8 @@ type App struct {
 	// Type:
 	//   string
 	// Description:
-	//   Comma separated list of keywords about the app.
+	//   Comma separated list of keywords about the app. Only one of
+	//   ‘keywords’ or ‘kwarray’ may be present.
 	Keywords string `json:"keywords,omitempty"`
 
 	// Attribute:
diff --git a/openrtb2/content.go b/openrtb2/content.go
index e07c9e0..42b68b8 100644
--- a/openrtb2/content.go
+++ b/openrtb2/content.go
@@ -173,7 +173,8 @@ type Content struct {
 	// Type:
 	//   string
 	// Description:
-	//   Comma separated list of keywords describing the content.
+	//   Comma separated list of keywords describing the content. Only
+	//   one of ‘keywords’ or ‘kwarray’ may be present.
 	Keywords string `json:"keywords,omitempty"`
 
 	// Attribute:
diff --git a/openrtb2/site.go b/openrtb2/site.go
index cd178ed..1beb89d 100644
--- a/openrtb2/site.go
+++ b/openrtb2/site.go
@@ -134,7 +134,8 @@ type Site struct {
 	// Type:
 	//   string
 	// Description:
-	//   Comma separated list of keywords about the site.
+	//   Comma separated list of keywords about the site. Only one of
+	//  ‘keywords’ or ‘kwarray’ may be present.
 	Keywords string `json:"keywords,omitempty"`
 
 	// Attribute: