diff --git a/api-docs/influxdb3/core/.config.yml b/api-docs/influxdb3/core/.config.yml
index 52ae681b6..1b83bee88 100644
--- a/api-docs/influxdb3/core/.config.yml
+++ b/api-docs/influxdb3/core/.config.yml
@@ -10,3 +10,7 @@ apis:
     root: v3/ref.yml
     x-influxdata-docs-aliases:
       - /influxdb3/core/api/
+      - /influxdb3/core/api/v1/
+      - /influxdb3/core/api/v2/
+      - /influxdb3/core/api/v1-compatibility
+      - /influxdb3/core/api/v2-compatibility
diff --git a/api-docs/influxdb3/enterprise/.config.yml b/api-docs/influxdb3/enterprise/.config.yml
index 01fc29e46..5ad79f54f 100644
--- a/api-docs/influxdb3/enterprise/.config.yml
+++ b/api-docs/influxdb3/enterprise/.config.yml
@@ -10,3 +10,7 @@ apis:
     root: v3/ref.yml
     x-influxdata-docs-aliases:
       - /influxdb3/enterprise/api/
+      - /influxdb3/enterprise/api/v1/
+      - /influxdb3/enterprise/v2/
+      - /influxdb3/enterprise/v1-compatibility
+      - /influxdb3/enterprise/v2-compatibility
\ No newline at end of file
diff --git a/content/influxdb3/core/write-data/_index.md b/content/influxdb3/core/write-data/_index.md
index bd179e2b0..8cde35b1b 100644
--- a/content/influxdb3/core/write-data/_index.md
+++ b/content/influxdb3/core/write-data/_index.md
@@ -1,5 +1,5 @@
 ---
-title: Write data to {{% product-name %}}
+title: Write data to {{< product-name >}}
 list_title: Write data
 description: >
   Collect and write time series data to {{% product-name %}}.
diff --git a/content/influxdb3/enterprise/write-data/_index.md b/content/influxdb3/enterprise/write-data/_index.md
index 892af242d..92b07f1ff 100644
--- a/content/influxdb3/enterprise/write-data/_index.md
+++ b/content/influxdb3/enterprise/write-data/_index.md
@@ -1,5 +1,5 @@
 ---
-title: Write data to {{% product-name %}}
+title: Write data to {{< product-name >}}
 list_title: Write data
 description: >
   Collect and write time series data to {{% product-name %}}.
diff --git a/content/shared/influxdb3-write-guides/_index.md b/content/shared/influxdb3-write-guides/_index.md
index ed2c7854d..f95c94b7a 100644
--- a/content/shared/influxdb3-write-guides/_index.md
+++ b/content/shared/influxdb3-write-guides/_index.md
@@ -10,6 +10,22 @@ to line protocol.
 - [Write data to InfluxDB](#write-data-to-influxdb)
   {{< children type="anchored-list" >}}
 
+{{% show-in "core,enterprise" %}}
+> [!Note]
+> 
+> #### Choose the write endpoint for your workload
+> 
+> When creating new write workloads, use the HTTP API
+> [`/api/v3/write_lp` endpoint with client libraries](/influxdb3/version/write-data/api-client-libraries/).
+>
+> When bringing existing v1 write workloads, use the {{% product-name %}}
+> HTTP API [`/write` endpoint](/influxdb3/core/api/v3/#operation/PostV1Write).
+>
+> When bringing existing v2 write workloads, use the {{% product-name %}}
+> HTTP API [`/api/v2/write` endpoint]([/influxdb3/version/api/v3/#operation/PostV1Write](/influxdb3/version/api/v3/#operation/PostV2Write)).
+{{% /show-in %}}
+
+{{% hide-in "core,enterprise" %}}
 > [!Note]
 > 
 > #### Choose the write endpoint for your workload
@@ -18,6 +34,7 @@ to line protocol.
 > HTTP API [`/write` endpoint](/influxdb3/version/guides/api-compatibility/v1/).
 > When creating new write workloads, use the HTTP API
 > [`/api/v2/write` endpoint](/influxdb3/version/guides/api-compatibility/v2/).
+{{% /hide-in %}}
 
 ## Line protocol