---
url: /process-functions/mapping-rowadd.md
description: Adds a row to a mapping.
---

# mapping.rowAdd

Adds a row to a mapping. If the keys on one side conflict with another row, that row is removed, so there is always a 1:1 mapping between the keys on each side.

Every element must already exist in its dimension.

```js
mapping.rowAdd(mappingName, leftKeys, rightKeys)
```

## Parameters

| Parameter | Type | Description |
|---|---|---|
| `mappingName` | `string` | The mapping's name or id. |
| `leftKeys` | `string[]` | One element for each dimension on the left side, in order. |
| `rightKeys` | `string[]` | One element for each dimension on the right side, in order. |

## Returns

`true` if the row was added, otherwise `false`.

## Examples

```js
mapping.rowAdd("Time to Year and Month", ["FY2017 - Jul"], ["2017", "Jul"]);
```

## Related

* [mapping.rowUpdate](/process-functions/mapping-rowupdate)
* [mapping.rowDelete](/process-functions/mapping-rowdelete)
* [mapping.wipe](/process-functions/mapping-wipe)