diff --git a/packages/dialog/stories/index.stories.mdx b/packages/dialog/stories/index.stories.mdx
index 5a24881c6..1f1c6ca2a 100644
--- a/packages/dialog/stories/index.stories.mdx
+++ b/packages/dialog/stories/index.stories.mdx
@@ -1,5 +1,6 @@
import { Story, Meta, html } from '@open-wc/demoing-storybook';
import demoStyle from './demo-dialog-style.js';
+import './styled-dialog-content.js';
import '../lion-dialog.js';
@@ -76,7 +77,103 @@ The documentation of the full config object can be found in the `lion/overlay` p
The `config` property uses a setter to merge the passed configuration with the current, so you only **overwrite what you pass** when updating `config`.
+### Styling content
+It's not possible to style content from the dialog component. This is because the content slot is moved to the global root node. This is why a custom component should be created and slotted in as the content. This ensures style encapsulation on the dialog content.
+
+
Hello person who opened the dialog!
Look how nice this dialog looks!
/div> + + `; + } +} + +customElements.define('styled-dialog-content',StyledDialogContent); +``` + +### Close overlay from component slotted as content + +The overlay cannot be closed by dispatching the `close-overlay` from a button in a styled component that is slotted in as content, because it will not cross the shadow boundary of the component. A method should be created that will dispatch the `close-overlay` event from the component. + +Hello person who opened the dialog!
Look how nice this dialog looks!
/div> + + `; +} +``` ### Placement overridesHello person who opened the dialog!
Look how nice this dialog looks!
+