> For the complete documentation index, see [llms.txt](https://docs.onum.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.onum.com/pipelines/actions/enrichment/lookup.md).

# Lookup

{% hint style="info" %}
See the changelog of this Action type [here](/actions-changelog/lookup.md).
{% endhint %}

## Overview

The **Lookup** action allows you to retrieve information from your uploaded lookups. To learn more about how to upload data, go to [**Enrichment**](/enrichment.md).

{% hint style="warning" %}
In order to configure this action, you must first link it to a Listener. Go to [Building a Pipeline ](/pipelines/building-a-pipeline.md)to learn how to link.
{% endhint %}

## Ports <a href="#ports" id="ports"></a>

These are the input and output ports of this Action:

<details>

<summary>Input ports</summary>

* **Default port** - All the events to be processed by this Action enter through this port.

</details>

<details>

<summary>Output ports</summary>

* **Default port** - Events are sent through this port if no error occurs while processing them.
* **Error port** - Events are sent through this port if an error occurs while processing them.

</details>

## Configuration

{% stepper %}
{% step %}
Find **Lookup** in the **Actions** tab (under the **Enrichment** group) and drag it onto the canvas. Link it to the required [Listener](https://docs.onum.com/the-workspace/listeners) and [Data sink](https://docs.onum.com/the-workspace/pipelines/data-sinks).
{% endstep %}

{% step %}
To open the configuration, click the Action in the canvas and select **Configuration**.
{% endstep %}

{% step %}
Enter the required parameters:

<table><thead><tr><th width="167">Parameter</th><th>Description</th></tr></thead><tbody><tr><td><strong>Select table</strong></td><td>Select the table you wish to retrieve data from. The tables that show here in the list will be those you previously uploaded in the <strong>Enrichment</strong> view.</td></tr><tr><td><strong>Key columns</strong></td><td>The <strong>Key column</strong> you selected during the upload will automatically appear. Select the field to search for this key column.</td></tr><tr><td><strong>Outputs</strong></td><td>Choose the field that will be injected from the drop-down and assign it a name. Add as many as required.</td></tr></tbody></table>
{% endstep %}

{% step %}
Click **Save** to complete.
{% endstep %}
{% endstepper %}