diff --git a/fern/pages/docs/components/accordion-groups.mdx b/fern/pages/docs/components/accordion-groups.mdx
index 8a5ec7624a2..37cd6ad3e1b 100644
--- a/fern/pages/docs/components/accordion-groups.mdx
+++ b/fern/pages/docs/components/accordion-groups.mdx
@@ -1,52 +1,95 @@
---
title: 'Accordion Groups'
-description: Display expandable/collapsible options that can reveal more information
+description: 'Display expandable/collapsible options that reveal more information with improved search functionality'
icon: 'table-rows'
---
+
+Accordion Groups allow you to organize content into collapsible sections, making it easier for users to navigate through information. With recent updates, our Accordion component now supports improved search functionality using the browser's built-in search feature.
+
-
- You can put other components inside Accordions.
+
+ Accordion Groups can contain multiple Accordion items. Each item has a title and content that can be expanded or collapsed.
- ```ts index.ts
- export function generateRandomNumber() {
- return Math.random();
- }
+ ```jsx
+
+
+ Content for section 1
+
+
+ Content for section 2
+
+
```
-
-
- This is a second option.
+
+ The updated Accordion component now uses HTML5 `` and `` elements, enabling browser search (Cmd+F / Ctrl+F) to find content within collapsed sections.
-
-
- This is a third option.
+
+
+ Our Accordion component is built with accessibility in mind, supporting keyboard navigation and screen readers.
+### Enhanced Search Functionality
+
+The recent update to our Accordion component improves content discoverability by allowing users to search through all content, including collapsed sections, using the browser's search function (Cmd+F / Ctrl+F).
+
+
+### Usage Examples
+
+Here are some examples of how to use the Accordion Group component:
+
+
+
+ This is a basic example with text content.
+
+
+
+ You can include code snippets within Accordions:
+
+ ```javascript
+ function greet(name) {
+ console.log(`Hello, ${name}!`);
+ }
+ ```
+
+
+
+ Accordions can contain other components:
+
+
+
+
+
+
+
+
+