diff --git a/website/www/site/content/en/documentation/patterns/cross-language.md b/website/www/site/content/en/documentation/sdks/java-multi-language-pipelines.md
similarity index 93%
rename from website/www/site/content/en/documentation/patterns/cross-language.md
rename to website/www/site/content/en/documentation/sdks/java-multi-language-pipelines.md
index 37585089e8db..33bd11a47873 100644
--- a/website/www/site/content/en/documentation/patterns/cross-language.md
+++ b/website/www/site/content/en/documentation/sdks/java-multi-language-pipelines.md
@@ -1,5 +1,8 @@
 ---
-title: "Cross-language transforms"
+type: languages
+title: "Java multi-language pipelines quickstart"
+aliases:
+  - /documentation/patterns/cross-language/
 ---
 
 <!--
@@ -14,11 +17,11 @@ See the License for the specific language governing permissions and
 limitations under the License.
 -->
 
-# Cross-language transforms
+# Java multi-language pipelines quickstart
 
-With the samples on this page we will demonstrate how to create and leverage cross-language pipelines.
+> **Note:** This page is a work in progress. Please see [Multi-language pipelines](https://beam.apache.org/documentation/programming-guide/#multi-language-pipelines) for full documentation.
 
-> **Note:** Please see the [Beam Programming Guide](https://beam.apache.org/documentation/programming-guide/#multi-language-pipelines) for full documentation on cross-language transforms.
+This page demonstrates how to write a Java pipeline that uses a Python cross-language transform.
 
 The goal of a cross-language pipeline is to incorporate transforms from one SDK (e.g. the Python SDK) into a pipeline written using another SDK (e.g. the Java SDK). This enables having already developed transforms (e.g. ML transforms in Python) and libraries (e.g. the vast library of IOs in Java), and strengths of certain languages at your disposal in whichever language you are more comfortable authoring pipelines while vastly expanding your toolkit in given language.
 
diff --git a/website/www/site/content/en/documentation/sdks/java.md b/website/www/site/content/en/documentation/sdks/java.md
index 0382ec56fc4d..71d6385ac088 100644
--- a/website/www/site/content/en/documentation/sdks/java.md
+++ b/website/www/site/content/en/documentation/sdks/java.md
@@ -47,3 +47,7 @@ The Java SDK has the following extensions:
 - [euphoria](/documentation/sdks/java/euphoria) is easy to use Java 8 DSL for BEAM.
 
 In addition several [3rd party Java libraries](/documentation/sdks/java-thirdparty/) exist.
+
+## Java multi-language pipelines quickstart
+
+Apache Beam lets you combine transforms written in any supported SDK language and use them in one multi-language pipeline. To learn how to create a multi-language pipeline using the Java SDK, see the [Java multi-language pipelines quickstart](/documentation/sdks/java-multi-language-pipelines).
diff --git a/website/www/site/layouts/partials/section-menu/en/documentation.html b/website/www/site/layouts/partials/section-menu/en/documentation.html
index 3f09b0e19d70..b144c7f20cae 100644
--- a/website/www/site/layouts/partials/section-menu/en/documentation.html
+++ b/website/www/site/layouts/partials/section-menu/en/documentation.html
@@ -205,7 +205,6 @@
     <li><a href="/documentation/patterns/ai-platform/">AI Platform</a></li>
     <li><a href="/documentation/patterns/schema/">Schema</a></li>
     <li><a href="/documentation/patterns/bqml/">BigQuery ML</a></li>
-    <li><a href="/documentation/patterns/cross-language/">Cross-language transforms</a></li>
     <li><a href="/documentation/patterns/grouping-elements-for-efficient-external-service-calls/">Grouping elements for efficient external service calls</a></li>
   </ul>
 </li>
diff --git a/website/www/site/layouts/partials/section-menu/en/sdks.html b/website/www/site/layouts/partials/section-menu/en/sdks.html
index 52419e8a2acc..ef0b2bbdaaf4 100644
--- a/website/www/site/layouts/partials/section-menu/en/sdks.html
+++ b/website/www/site/layouts/partials/section-menu/en/sdks.html
@@ -24,6 +24,7 @@
     <li><a href="/documentation/sdks/java-extensions/">Java SDK extensions</a></li>
     <li><a href="/documentation/sdks/java-thirdparty/">Java 3rd party extensions</a></li>
     <li><a href="/documentation/sdks/java/testing/nexmark/">Nexmark benchmark suite</a></li>
+    <li><a href="/documentation/sdks/java-multi-language-pipelines/">Java multi-language pipelines quickstart</a></li>
   </ul>
 </li>