diff --git a/apps/docs/src/pages/components/layer/index.mdx b/apps/docs/src/pages/components/layer/index.mdx
index bc67f307f..11ec83039 100644
--- a/apps/docs/src/pages/components/layer/index.mdx
+++ b/apps/docs/src/pages/components/layer/index.mdx
@@ -1,5 +1,10 @@
 import { Button, Notification } from 'grommet';
-import { AccessibilitySection, BestPracticeGroup, Example, StyleTable } from '../../../layouts';
+import {
+  AccessibilitySection,
+  BestPracticeGroup,
+  Example,
+  StyleTable,
+} from '../../../layouts';
 import {
   ActionLabels,
   ActionLabelTitle,
@@ -29,9 +34,27 @@ import { Checkmark } from '@hpe-design/icons-grommet';
   <LayerExample />
 </Example>
 
-## When to use
+## Use cases
+
+### Confirming next steps
+
+[Placeholder for confirming next steps example]
+
+### Confirming destructive deletion
+
+[Placeholder for confirming destructive deletion example]
+
+### Adding a new record
 
-A layer should be used to present information or task flows to the user without navigating them away from their current context.
+[Placeholder for adding a new record example]
+
+### Filtering data
+
+[Placeholder for filtering data example]
+
+### Completing a multi‑step process
+
+[Placeholder for completing a multi-step process example]
 
 ## Anatomy
 
@@ -340,6 +363,7 @@ For example, implementation of this "Close" button for a Layer would be:
   autoFocus
 />
 ```
+
 ### WCAG compliance
 
-<AccessibilitySection title='layer' />
+<AccessibilitySection title="layer" />