---
title: "system.dataset.appendDataset"
description: "Takes two different datasets and returns a new dataset with the second dataset appended to the first."
---

# system.dataset.appendDataset

> Takes two different datasets and returns a new dataset with the second dataset appended to the first.

This function is used in **Python Scripting**.

## Description
Takes two different datasets and returns a new dataset with the second dataset appended to the first. Will throw an error if the number and types of columns do not match.

## Client Permission Restrictions
This scripting function has no [Client Permission](projects\project-properties\project-properties.md#client---permissions) restrictions.

## Syntax
`system.dataset.appendDataset(dataset1, dataset2)`

### Parameters
Type | Parameter | Description 
------- | ------- | -------
Dataset | `dataset1` | The dataset that will come first in the returned dataset.
Dataset | `dataset2` | The second dataset that will be appended to the end in the returned dataset.

### Returns
**Dataset** - A new dataset that is a combination of the original two datasets.

### Scope
All

## Code Examples

```python title="Example 1"
# This example pulls in the datasets from two different table components, combines them, then writes the results to a third table.
# the two source datasets must have the same number and types of columns.
 
data1 = event.source.parent.getComponent('Table 1').data
data2 = event.source.parent.getComponent('Table 2').data
comboData = system.dataset.appendDataset(data1, data2)
event.source.parent.getComponent('Table 3').data = comboData
```