update

src/pages/components/contained-list/style.mdx

@@ -188,6 +188,18 @@ in a phrase and any proper nouns capitalized.
   Structure and spacing measurements for decorative icons. | px / rem
 </Caption>
 
+<br />
+
+<div className="image--fixed">
+
+![Structure and spacing measurements for search and filtering.](images/contained-list-search-style.png)
+
+</div>
+
+<Caption>
+  Structure and spacing measurements for search and filtering. | px / rem
+</Caption>
+
 ## Size
 
 ### On-page list

src/pages/components/contained-list/usage.mdx

@@ -124,9 +124,14 @@ and optional interactive elements.
 </Row>
 
 1. **List header area:** Area to group the succeeding list items.
-2. **List title:** Descriptive name for the group of list items.
-3. **List item:** The content with in a list item row.
-4. **Interactive element** (optional): An interactive element in the header or
+2. **List item area:** Area to group text and elements in a list row.
+3. **List title:** Descriptive name for the group of list items.
+4. **List item:** The content in a list item row.
+5. **Decorative icon (optional):** A non-interactive icon to help visually
+   describe a list item.
+6. **Search icon (optional):** An icon to represent search or filtering
+   functionality in the contained list.
+7. **Interactive element** (optional): An interactive element in the header or
    row such as a button, link, icon, or toggle.
 
 ### Alignment
@@ -336,10 +341,10 @@ multiple column headers, we recommend using a data table instead.
 
 ### Decorative icons
 
-Contained lists can have decorative icons in rows positioned before the text in
-each row to help visually describe the list item, category, or status. These
-icons are non-interactive elements and are used for visual purposes only. Icons
-should typically be the same color as the text in the row unless they are status
+Contained lists can have decorative icons positioned before the text in each row
+to help visually describe the list item, category, or status. These icons are
+non-interactive elements and are used for visual purposes only. Icons should
+typically be the same color as the text in the row unless they are status
 indicators.
 
 <Row>