diff --git a/docs/custom-event-goals.md b/docs/custom-event-goals.md
index 2310c4e5..2f0dee9d 100644
--- a/docs/custom-event-goals.md
+++ b/docs/custom-event-goals.md
@@ -209,6 +209,33 @@ Once you’ve made the necessary changes, simply click "Update goal," and your u
Custom properties can be attached to events to capture dynamic elements and to further break down goal conversions. You can use custom properties to create your custom metrics to collect and analyze data that Plausible doesn't automatically track. [Learn more here](/custom-props/for-custom-events).
+### Automatically attached properties
+
+#### `url`
+
+For clicks on links (`` elements) tagged with `plausible-event-name=...`, we automatically track where the link is pointing (its `href` property).
+
+:::note
+This property is not automatically attached when the tagged `` element is within `