diff --git a/packages/main/src/components/Modals/index.tsx b/packages/main/src/components/Modals/index.tsx
index 748609b64ae..603fd8ed563 100644
--- a/packages/main/src/components/Modals/index.tsx
+++ b/packages/main/src/components/Modals/index.tsx
@@ -226,6 +226,8 @@ function showToastFn(props: ToastPropTypes, container?: Element | DocumentFragme
  *
  * **In order to use these helpers, please make sure to render the `Modals` component somewhere in your application tree.**
  *
+ * __Note:__ The `Toast` component does not currently use the [Popover API](https://developer.mozilla.org/en-US/docs/Web/API/Popover_API), which may cause issues like incorrect positioning or alignment. If that's the case, please mount the `Modals` component after all other components, or define a custom container via the `container` parameter.
+ *
  * @since 0.22.2
  */
 export function Modals() {
@@ -257,4 +259,7 @@ Modals.showPopover = showPopoverFn;
 Modals.showResponsivePopover = showResponsivePopoverFn;
 Modals.showMenu = showMenuFn;
 Modals.showMessageBox = showMessageBoxFn;
+/**
+ * __Note:__ The `Toast` component does not currently use the [Popover API](https://developer.mozilla.org/en-US/docs/Web/API/Popover_API), which may cause issues like incorrect positioning or alignment. If that's the case, please mount the `Modals` component after all other components, or define a custom container via the `container` parameter.
+ */
 Modals.showToast = showToastFn;
diff --git a/packages/main/src/webComponents/Toast/index.tsx b/packages/main/src/webComponents/Toast/index.tsx
index 6db0e447b33..3f432cff026 100644
--- a/packages/main/src/webComponents/Toast/index.tsx
+++ b/packages/main/src/webComponents/Toast/index.tsx
@@ -73,6 +73,7 @@ interface ToastPropTypes extends ToastAttributes, Omit<CommonProps, keyof ToastA
  * - You want users to be able to copy some part of the message text.
  *
  *
+ * __Note:__ The `Toast` component does not currently use the [Popover API](https://developer.mozilla.org/en-US/docs/Web/API/Popover_API), which may cause issues like incorrect positioning or alignment. To avoid these side effects, we recommend mounting the `Toast` outside the parents' DOM hierarchy, either directly or by using `React.createPortal`, until the Popover API is integrated into this component as well.
  *
  * __Note__: This is a UI5 Web Component! [Repository](https://github.com/SAP/ui5-webcomponents) | [Documentation](https://sap.github.io/ui5-webcomponents/)
  */