diff --git a/docs/6.x/docs/components/Dialog/Dialog.mdx b/docs/6.x/docs/components/Dialog/Dialog.mdx
index e871f7f750..8a9f1381c8 100644
--- a/docs/6.x/docs/components/Dialog/Dialog.mdx
+++ b/docs/6.x/docs/components/Dialog/Dialog.mdx
@@ -11,6 +11,19 @@ import ExtendedExample from '@docs/components/ExtendedExample.tsx';
Dialogs inform users about a specific task and may contain critical information, require decisions, or involve multiple tasks.
To render the `Dialog` above other components, you'll need to wrap it with the [`Portal`](../Portal/Portal) component.
+## Recommended props
+
+| Prop | Type | Description |
+| --- | --- | --- |
+| `icon` | `IconSource` | Icon rendered through `Dialog.Icon`. |
+| `title` | `ReactNode` | Dialog title rendered through `Dialog.Title`. |
+| `content` | `ReactNode` | Required dialog content. Non-empty strings use Material 3 supporting-text styles. |
+| `actions` | `DialogActionsProps[]` | Action labels, press handlers, and Button props. |
+| `scrollable` | `boolean` | Renders content through `Dialog.ScrollArea` and a `ScrollView`. |
+| `contentProps` | `DialogContentProps` | Props forwarded to `Dialog.Content`. |
+| `scrollAreaProps` | `DialogScrollAreaProps` | Props forwarded to `Dialog.ScrollArea`. |
+| `scrollViewProps` | `ScrollViewProps` | Props forwarded to `ScrollView`. |
+
@@ -21,7 +34,7 @@ To render the `Dialog` above other components, you'll need to wrap it with the [
```js
import * as React from 'react';
import { View } from 'react-native';
-import { Button, Dialog, Portal, PaperProvider, Text } from 'react-native-paper';
+import { Button, Dialog, Portal, PaperProvider } from 'react-native-paper';
const MyComponent = () => {
const [visible, setVisible] = React.useState(false);
@@ -35,15 +48,13 @@ const MyComponent = () => {
-
+
@@ -53,6 +64,32 @@ const MyComponent = () => {
export default MyComponent;
```
+## Compound composition
+
+`Dialog.Icon`, `Dialog.Title`, `Dialog.Content`, `Dialog.ScrollArea`, and
+`Dialog.Actions` remain available for custom composition within `Dialog`.
+Passing them through `children` is deprecated; prefer the props above.
+
+## Migrating from children
+
+```js
+// Before
+
+
+// After
+
+```
+
## Props
@@ -93,7 +130,7 @@ export default MyComponent;
-### children (required)
+### children (depracated, use props instead)
diff --git a/docs/6.x/docs/components/Dialog/DialogIcon.mdx b/docs/6.x/docs/components/Dialog/DialogIcon.mdx
index 34777210ca..a736d9d384 100644
--- a/docs/6.x/docs/components/Dialog/DialogIcon.mdx
+++ b/docs/6.x/docs/components/Dialog/DialogIcon.mdx
@@ -20,7 +20,6 @@ A component to show an icon in a Dialog.
## Usage
```js
import * as React from 'react';
-import { StyleSheet } from 'react-native';
import { Dialog, Portal, Text } from 'react-native-paper';
const MyComponent = () => {
@@ -32,7 +31,7 @@ const MyComponent = () => {