_LookupBrowse
Last updated 19/12/2024
Overview
This documentation will demonstrate how to use Five's display type _LookupBrowse. _LookupBrowse enables you to browse through the records in the lookup list and view all the details for a record without leaving the current view. The records will stay in a read-only format, however, when the record is selected it will be populated in the field.
Let's take a look at an example. In the Soul Food application, we have a list of ingredient records. When you select a record, you have all the details about the ingredient.
![Ingredient records](/2.7/img/setup/display-types/default-display-types/lookups/lookup-browse/example/ingredient-records.png)
There is a Recipe form and ingredients can be added to the recipe. A category can be selected and then the Browse button can be used in the Ingredient field.
![Browse button](/2.7/img/setup/display-types/default-display-types/lookups/lookup-browse/example/browse-button.png)
When the Browse button is clicked, the full record for the first ingredient will be available. You can browse between the records by clicking the Next and Previous buttons.
![Next and Previous buttons](/2.7/img/setup/display-types/default-display-types/lookups/lookup-browse/example/browse-buttons.png)
Once you have decided which record you want, the Save button can be clicked for the ingredient.
![Save button](/2.7/img/setup/display-types/default-display-types/lookups/lookup-browse/example/save-button.png)
The ingredient will then be populated in the Ingredient field on the Recipe Ingredients form.
![Ingredient field](/2.7/img/setup/display-types/default-display-types/lookups/lookup-browse/example/ingredient-field.png)
Back in Five, the RecipeIngredient table has foreign relationships with the Recipe, Category, and Ingredient tables and the Category table has a foreign relationship with the Ingredient form. The foreign relationship between the Ingredient and RecipeIngredient tables makes it possible that when on the Recipe Ingredients form, you can use _LookupBrowse and browse through the ingredient records.
![Database model](/2.7/img/setup/display-types/default-display-types/lookups/lookup-with-dependent-field/table-relationships.png)
Form Setup
The Ingredients form has three fields.
![Ingredients form fields](/2.7/img/setup/display-types/default-display-types/lookups/lookup-browse/form-setup/ingredients-form.png)
The Recipes form has two pages, the Recipe Ingredients page is a list page which references the Recipe Ingredients form. This is the form we need to edit to add the _LookupBrowse display type to the Ingredient field.
![Recipes pages](/2.7/img/setup/display-types/default-display-types/lookups/lookup-browse/form-setup/recipes-form.png)
Add a _LookupBrowse Display Type
1. Select the record in the list.2. Click the Pages tab.
![Pages tab](/2.7/img/setup/display-types/default-display-types/lookups/lookup-browse/add-lookup-browse/pages-tab.png)
3. Select the page record.
![Page record](/2.7/img/setup/display-types/default-display-types/lookups/lookup-browse/add-lookup-browse/page-record.png)
4. Click the Fields tab.
![Fields tab](/2.7/img/setup/display-types/default-display-types/lookups/lookup-browse/add-lookup-browse/fields-tab.png)
5. Select the field record.
![Field record](/2.7/img/setup/display-types/default-display-types/lookups/lookup-browse/add-lookup-browse/field-record.png)
6. Either click the Edit button in the form app bar or click directly in the Display Type field.
![Edit button](/2.7/img/setup/display-types/default-display-types/lookups/lookup-browse/add-lookup-browse/edit-button.png)
7. Click the lookup icon in the Display Type field and select _LookupBrowse.
8. If you did not have the field previously set as a lookup, you will need to click the lookup icon in the Referenced Form field and select the form to reference to get the values for the list.
![Display Type field](/2.7/img/setup/display-types/default-display-types/lookups/lookup-browse/add-lookup-browse/display-type-field.png)
9. Click the Save button in the form app bar.
![Save button](/2.7/img/setup/display-types/default-display-types/lookups/lookup-browse/add-lookup-browse/save-button.png)
10. Click the Save button in the form app bar above the list.
![Save button](/2.7/img/setup/display-types/default-display-types/lookups/lookup-browse/add-lookup-browse/save-recipe-ingredient-form.png)
_LookupBrowse in the Form Wizard
If you know you want to use the display type _LookupBrowse on creation of your form while using the Form Wizard, select _LookupBrowse in the Display Type field.
![Display Type field](/2.7/img/setup/display-types/default-display-types/lookups/lookup-browse/display-type-field-form-wizard.png)