Lookup()

Returns data from a specific column in a data extension. To call this function, you supply the name of the column to search, the value to match, and the column to return.

If your search criteria return more than one result, the system returns the first matching value it finds. For this reason, it’s best to use this function to search for identifiers that are unique within the data extension.

AMPscript also includes several functions that you can use to retrieve several rows of data.

• The LookupRows() function retrieves one or more rows based on the criteria you specify.
• The LookupRowsCS() function is a case-sensitive version of the LookupRows() function.
• The LookupOrderedRows() function allows you to specify a column and direction to sort the rowset by.
• The LookupOrderedRowsCS() function is a case-sensitive version of LookupOrderedRows().

Lookup(dataExt,
       returnColumn,
       searchColumn1, searchValue1,
       [searchColumn2, searchValue2...])

• dataExt (string): Required. The name of the data extension that contains the data that you want to retrieve.
• returnColumn (string): Required. The name of the column to return data from.
• searchColumn1 (string): Required. The name of the column to search. This value is case-sensitive.
• searchValue1 (string): Required. The value that identifies the rows to retrieve. This value is case-sensitive.

You can optionally append additional search columns and values to the end of the parameter string.

This example uses a data extension called "Regions of Japan," which contains the data in this table.

This code searches for a row in which the value of the NameEN column is Kanto. It then returns the value in the NameJA column for that row.

%%[
  Var @kantoJA
  Set @kantoJA = Lookup("Regions of Japan", "NameJA", "NameEN", "Kanto")
]%%
<p>The name of the Kanto region in Japanese is %%=v(@kantoJA)=%%.</p>

The code example outputs the value of the specified column.

The name of the Kanto region in Japanese is 関東地方.

• LookupOrderedRows()
• LookupOrderedRowsCS()
• LookupRows()
• LookupRowsCS()