Advanced Table Expand Collapse All Documentation

website/docs/components/table/advanced-table/partials/guidelines/guidelines.md

@@ -144,6 +144,7 @@ Sticky headers keep column labels visible while scrolling, aiding navigation in
 
 ![](/assets/components/table/advanced-table/advanced-table-sticky-header.png)  
 
+
 ### Expandable rows
 
 Expandable rows let users show or hide more content without navigating away from the table. The expanded content should align with the header labels, even if the parent row includes minimal data.
@@ -167,6 +168,35 @@ Avoid using different density settings for parent and child rows.
 
 !!!
 
+### Expand/Collapse All Button
+The Expand/Collapse All button allows users to expand or collapse all rows, including nested rows. It provides quick access to more content but may impact readability when content is long or detailed.
+
+### Interactions
+
+#### Default state
+
+The Advanced Table supports any combination of expanded or collapsed rows on load. The button reflects the initial state.
+
+![Advanced Table with default height parent rows and short density nested rows.](/assets/components/table/advanced-table/expandable-rows-expand-all.png)
+<Doc::ImageCaption @text="Expand All if any rows are collapsed."/>
+
+![Advanced Table with default height parent rows and short density nested rows.](/assets/components/table/advanced-table/expandable-rows-collapse-all.png)
+<Doc::ImageCaption @text="Collapse All if all rows are expanded."/>
+
+### Collapsed state
+
+![Advanced Table with default height parent rows and short density nested rows.](/assets/components/table/advanced-table/expandable-rows-expand-state.png)
+<Doc::ImageCaption @text="Clicking Expand All expands all rows, including nested rows."/>
+
+### Expanded state
+
+![Advanced Table with default height parent rows and short density nested rows.](/assets/components/table/advanced-table/expandable-rows-collapse-state.png)
+<Doc::ImageCaption @text="Clicking Expand All expands all rows, including nested rows."/>
+
+### Mixed state 
+
+![Advanced Table with default height parent rows and short density nested rows.](/assets/components/table/advanced-table/expandable-rows-mixed-state.png)
+<Doc::ImageCaption @text="Clicking Expand All expands all rows, including nested rows."/>
 
 ### Striping