diff --git a/specs/common/schemas/IndexSettings.yml b/specs/common/schemas/IndexSettings.yml
index 3d0946df9a..1929466761 100644
--- a/specs/common/schemas/IndexSettings.yml
+++ b/specs/common/schemas/IndexSettings.yml
@@ -1008,7 +1008,7 @@ facetOrdering:
       $ref: '#/values'
 
 widgets:
-  description: widgets returned from any rules that are applied to the current search.
+  description: Widgets returned from any rules that are applied to the current search.
   type: object
   additionalProperties: false
   properties:
@@ -1016,13 +1016,13 @@ widgets:
       $ref: '#/banners'
 
 banners:
-  description: banners defined in the merchandising studio for the given search.
+  description: Banners defined in the Merchandising Studio for a given search.
   type: array
   items:
     $ref: '#/banner'
 
 banner:
-  description: a search banner with image and url.
+  description: Banner with image and link to redirect users.
   type: object
   additionalProperties: false
   properties:
@@ -1032,7 +1032,7 @@ banner:
       $ref: '#/bannerLink'
 
 bannerLink:
-  description: link for a banner defined in merchandising studio.
+  description: Link for a banner defined in the Merchandising Studio.
   type: object
   additionalProperties: false
   properties:
@@ -1040,7 +1040,7 @@ bannerLink:
       type: string
 
 bannerImage:
-  description: image of a search banner.
+  description: Image to show inside a banner.
   type: object
   additionalProperties: false
   properties:
@@ -1052,7 +1052,7 @@ bannerImage:
       type: string
 
 bannerImageUrl:
-  description: url for a search banner image.
+  description: URL for an image to show inside a banner.
   type: object
   additionalProperties: false
   properties: