> For the complete documentation index, see [llms.txt](https://docs.mashmatrix.com/mashmatrix-sheet/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.mashmatrix.com/mashmatrix-sheet/functions_about_editing_data/lookup_edit_and_search.md).

# Lookup Edit and Search

By double-clicking to edit a cell in a column where lookup entry is enabled, a dropdown will be displayed with candidate records to be referenced. If you wish to review detailed information about the records before selecting, click the search button **\[A]** on top of the dropdown to display the Lookup Search dialog for more detailed information.

![](/files/PAR0mLLE4iIl80KJLHvn)

## Lookup Search Dialog <a href="#lookup_search_dialog" id="lookup_search_dialog"></a>

![](/files/qCM6XmAp2HKBjed5h5GG)

The Lookup Search dialog displays referring records in a grid table format the same as the sheet.

Records can be queried using the search keyword **\[A]**. The keyword is matched against each field using the matching method specified in "Lookup Editor Settings" in the column settings.

The grid table in the Lookup Search dialog displays a menu **\[C]** in the column headers, just as in a regular sheet. Unlike the columns of the grid table in the sheet, only the following menus are available for selection.

* Sort Asc / Sort Desc
* Filter
* Add Columns
* Delete Column

Finally, check the Select Record radio button **\[B]** for the record you wish to select and press the "Select" button in the dialog to determine the record to be referenced.

{% hint style="warning" %}
Features such as "Fixed Sort" and "Filter Groups" are currently not supported in the grid table within the Lookup Search dialog. Inline record creation/editing is also not supported.
{% endhint %}

{% hint style="info" %}
Columns of the grid table in the Lookup Search dialog display the fields configured in "Lookup Name Field" and "Additional Display Field" in the Lookup Editor Setting. In addition, fields added or deleted by "Add Columns" or "Delete Column" in the Lookup Search dialog are automatically reflected in "Additional Display Field" in the Lookup Editor Setting.
{% endhint %}

{% hint style="info" %}
The "Lookup Search Condition" specified in the Lookup Editor setting for a column is always applied to the query in the Lookup Search dialog. Filters applied within the dialog only act as additional query conditions and do not remove the lookup search conditions that have already been set.
{% endhint %}

## Create Lookup Target Record

If “Allow to Create Record on Lookup Target Object” is enabled in the lookup editor settings of the column, the New Record button **\[A]** to create record in reference object will appear at the bottom of the dropdown in the list of candidate records.

<figure><img src="/files/ivyu8VIAb75lOKs6jFX7" alt=""><figcaption></figcaption></figure>

Clicking on the New Record button displays the dialog **\[B]** to create a new record. Fill in the required fields and click the Save button to create a record and associate it as a lookup target at the same time.

<figure><img src="/files/jGnRVj94siWfScqmeRBs" alt=""><figcaption></figcaption></figure>


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter:

```
GET https://docs.mashmatrix.com/mashmatrix-sheet/functions_about_editing_data/lookup_edit_and_search.md?ask=<question>&goal=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
