diff --git a/data/primitives/overview/releases.mdx b/data/primitives/overview/releases.mdx
index 074334051..25652afcd 100644
--- a/data/primitives/overview/releases.mdx
+++ b/data/primitives/overview/releases.mdx
@@ -55,6 +55,10 @@ metaDescription: Radix Primitives releases and their changelogs.
- [**Breaking**] Move `allowPinchZoom` to root
- [**Breaking**] Add new `Portal` part. To avoid regressions, use this part if you want portalling behavior. Note that `z-index` isn't managed anymore so you have full control of layering.
+
+
+- [**Breaking**] Note that `z-index` isn't managed anymore so you have full control of layering. The prop to provide a custom container evolves from `containerRef` (ref) to `container` (element). The `data-radix-portal` was removed because you can use `asChild` to control the element.
+
- Add `aria-required` to root
diff --git a/data/primitives/utilities/portal/0.1.5.mdx b/data/primitives/utilities/portal/0.1.5.mdx
index e3f59482a..c3d6b9c0f 100644
--- a/data/primitives/utilities/portal/0.1.5.mdx
+++ b/data/primitives/utilities/portal/0.1.5.mdx
@@ -49,16 +49,23 @@ export default () => Content;
### Root
-Anything you put inside this component will be rendered in a separate `
` element. By default, this element will be appended to `document.body` but you can choose a different container by using the `containerRef` prop.
+Anything you put inside this component will be rendered in a separate `
` element. By default, this element will be appended to `document.body` but you can choose a different container by using the `container` prop.
',
- typeSimple: 'ref',
+ name: 'asChild',
+ required: false,
+ type: 'boolean',
+ default: 'false',
description:
- 'A optional ref to a different container where the portaled content should be appended.',
+ 'Change the component to the HTML tag or custom component of the only child. This will merge the original component props with the props of the supplied element/component and change the underlying DOM node.',
+ },
+ {
+ name: 'container',
+ type: 'HTMLElement',
+ description:
+ 'A optional different container where the portaled content should be appended.',
},
]}
/>