From 0202cb9a1571e7d46e9f6fda215ae5f352eccbcc Mon Sep 17 00:00:00 2001
From: Mendon Kissling <59585235+mendonk@users.noreply.github.com>
Date: Wed, 22 Apr 2026 13:10:16 -0400
Subject: [PATCH] docs: concatenate and merge options for dataframe operations
 component (#12819)

* add-concatenate-and-merge-options

* Apply suggestions from code review

Co-authored-by: April I. Murphy <36110273+aimurphy@users.noreply.github.com>

---------

Co-authored-by: April I. Murphy <36110273+aimurphy@users.noreply.github.com>
---
 docs/docs/Components/dataframe-operations.mdx | 25 +++++++++++++++++++
 .../Components/dataframe-operations.mdx       | 25 +++++++++++++++++++
 2 files changed, 50 insertions(+)

diff --git a/docs/docs/Components/dataframe-operations.mdx b/docs/docs/Components/dataframe-operations.mdx
index 024c188eb8..3710b34827 100644
--- a/docs/docs/Components/dataframe-operations.mdx
+++ b/docs/docs/Components/dataframe-operations.mdx
@@ -109,6 +109,16 @@ The **Add Column** operation allows you to add a new column to the `Table` with
 
 The parameters are **New Column Name** (`new_column_name`) and **New Column Value** (`new_column_value`).
 
+</TabItem>
+<TabItem value="concatenate" label="Concatenate">
+
+The **Concatenate** operation combines multiple input `Table` objects into a single `Table` by stacking their rows vertically.
+For example, if you have Table A and Table B, they are combined into one table with all rows from Table A, and then all rows from Table B.
+
+This operation uses the **Table** (`df`) input.
+Connect multiple `Table` outputs to the same input to concatenate them.
+The output is a single `Table` containing the combined rows from all connected inputs.
+
 </TabItem>
 <TabItem value="dropcolumn" label="Drop Column">
 
@@ -134,6 +144,21 @@ The default is `5`.
 
 The output is a `Table` containing only the selected rows.
 
+</TabItem>
+<TabItem value="merge" label="Merge">
+
+The **Merge** operation combines two input `Table` objects by matching rows that share the same value in a selected column.
+For example, if one table has `id` and `name`, and another has `id` and `department`, you can merge both tables on `id` to produce one table with `id`, `name`, and `department`.
+
+Provide the following parameters:
+
+* **Left Table** (`left_dataframe`): The primary table in the merge.
+* **Right Table** (`right_dataframe`): The secondary table in the merge.
+* **Merge On Column** (`merge_on_column`): The shared column used to match rows. This column must exist in both tables.
+* **Merge Type** (`merge_how`): Controls which matched and unmatched rows are kept in the output. Use `inner` to keep only matching rows, `left` to keep all rows from the left table, `right` to keep all rows from the right table, or `outer` to keep all rows from both tables.
+
+The output is a `Table` containing matched records from both inputs.
+
 </TabItem>
 <TabItem value="renamecolumn" label="Rename Column">
 
diff --git a/docs/versioned_docs/version-1.9.0/Components/dataframe-operations.mdx b/docs/versioned_docs/version-1.9.0/Components/dataframe-operations.mdx
index 024c188eb8..4599f24231 100644
--- a/docs/versioned_docs/version-1.9.0/Components/dataframe-operations.mdx
+++ b/docs/versioned_docs/version-1.9.0/Components/dataframe-operations.mdx
@@ -109,6 +109,16 @@ The **Add Column** operation allows you to add a new column to the `Table` with
 
 The parameters are **New Column Name** (`new_column_name`) and **New Column Value** (`new_column_value`).
 
+</TabItem>
+<TabItem value="concatenate" label="Concatenate">
+
+The **Concatenate** operation combines multiple input `Table` objects into a single `Table` by stacking their rows vertically.
+For example, if you have Table A, and Table B, they are combined into one table with all rows from Table A, and then all rows from Table B.
+
+This operation uses the **Table** (`df`) input.
+Connect multiple `Table` outputs to the same input to concatenate them.
+The output is a single `Table` containing the combined rows from all connected inputs.
+
 </TabItem>
 <TabItem value="dropcolumn" label="Drop Column">
 
@@ -134,6 +144,21 @@ The default is `5`.
 
 The output is a `Table` containing only the selected rows.
 
+</TabItem>
+<TabItem value="merge" label="Merge">
+
+The **Merge** operation combines two input `Table` objects by matching rows that share the same value in a selected column.
+For example, if one table has `id` and `name`, and another has `id` and `department`, you can merge both tables on `id` to produce one table with `id`, `name`, and `department`.
+
+Provide the following parameters:
+
+* **Left Table** (`left_dataframe`): The primary table in the merge.
+* **Right Table** (`right_dataframe`): The secondary table in the merge.
+* **Merge On Column** (`merge_on_column`): The shared column used to match rows. This column must exist in both tables.
+* **Merge Type** (`merge_how`): Controls which matched and unmatched rows are kept in the output. Use `inner` to keep only matching rows, `left` to keep all rows from the left table, `right` to keep all rows from the right table, or `outer` to keep all rows from both tables.
+
+The output is a `Table` containing matched records from both inputs.
+
 </TabItem>
 <TabItem value="renamecolumn" label="Rename Column">