---
url: /process-functions/mapping-findusingright.md
description: Finds a mapping row by its right keys.
---

# mapping.findUsingRight

Finds a mapping row by its right keys.

```js
mapping.findUsingRight(mappingName, rightKeys)
```

## Parameters

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

## Returns

The row as a JSON string, with its `id`, `left` keys and `right` keys. Use `JSON.parse()` to read it. Returns `null` when no row matches.

## Examples

::: code-group

```js [find.js]
const row = JSON.parse(mapping.findUsingRight("Time to Year and Month", ["2017", "Jul"]));
console.log(row);
```

```json [Output]
{
    "id": 1,
    "left": [
        "FY2017 - Jul"
    ],
    "right": [
        "2017",
        "Jul"
    ]
}
```

:::

## Related

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