diff --git a/content/en/docs/refguide/modeling/pages/page/page-properties.md b/content/en/docs/refguide/modeling/pages/page/page-properties.md
index 8c87d3e1a3b..2c2b6a5642f 100644
--- a/content/en/docs/refguide/modeling/pages/page/page-properties.md
+++ b/content/en/docs/refguide/modeling/pages/page/page-properties.md
@@ -97,6 +97,10 @@ In simple e-commerce applications, the URLs can be configured as follows:
 
 * *category/{Category/Code}/product/{Product/Name}* - the URL for a page that shows a product and a category (in a browser, the URL will look like `http://example.mendixcloud.com/p/category/tools/product/hammer` where `tools` is used to retrieve the `Category` by its `Code`, and `hammer` is used to retrieve the `Product` by its `Name`)
 
+{{% alert color="warning" %}}
+We don't recommend configuring page URLs for pages that are displayed as a pop-up. Navigating to such a URL will result in layout issues with the pop-up being opened with no other page behind it.
+{{%/alert %}}
+
 ### Common Section {#common}
 
 {{% snippet file="/static/_includes/refguide/common-section-link.md" %}}