Merge pull request #2098 from MicrosoftDocs/mintsOct28thLookups

Mints oct28th lookups

Author: mduelae

powerapps-docs/user/lookup-field.md

@@ -5,7 +5,7 @@ manager: kvivek
 ms.service: powerapps
 ms.component: pa-user
 ms.topic: conceptual
-ms.date: 10/03/2019
+ms.date: 10/28/2019
 ms.author: mkaur
 ms.reviewer: ""
 ms.assetid: 
@@ -19,24 +19,83 @@ search.app:
 
 Lookup helps you to choose records from a related entity. When you select a related entity and enter search criteria, such as a name or email address, lookup automatically begins to resolve the partial text and displays any matching records. If no records are displayed after you have typed the full text of your search criteria, a message is displayed specifying that there are no records.
 
-To browse a lookup, when you see the list of results, press Enter.
+For example, you might search for the name **Adrian Dumitrascu**. When you type **ad**, possible matching records are automatically populated and displayed.
 
   > [!div class="mx-imgBorder"]
-  > ![Browse a lookup field](media/Lookup_02-MRUandBrowse[1].gif "Browse a lookup field")  
- 
-The list of records shows an image to help distinguish between record types.
+  > ![Automatically populates matching records](media/automatically-populate-matching-records.png "Automatically populates matching records")
+  
+>[!NOTE] 
+>An administrator can define the criteria that lookup uses for resolving partial search text.
+
+Also, you can create a new record by selecting the **New** button. You must have sufficient permissions to view the **New** button and create a record. When you select the lookup field, the five most recently used records are displayed along with five favorite records. Which records are displayed depends on your view history and the favorites you’ve pinned. 
+
+For example, if you have only three records in your history, lookup will display those three,
+along with seven of your favorite records. If you have not pinned any favorites, only the most recently viewed records will be displayed.
+
+## Types of lookups
+
+Lookups are classified into the following: 
+
+- **Simple lookup:** Select a single record in a field from a single entity. 
+
+- **PartyList-type fields:** Use to select multiple records from multiple entities in a lookup. Use partylist-type fields to select multiple records. This allows you to add each record by performing a new search, multiple times. Every time you select a record, you will be able to perform a new search for another record.
+  
+- **Regarding-type fields:** Use to select a single record from multiple entities in a lookup. 
+
+## Search in a lookup field 
+To search a lookup, select the textbox and type your search criteria. If recent records are enabled for your lookup, your recent records will be displayed when you select the textbox.
 
   > [!div class="mx-imgBorder"]
-  > ![Lookup fields shows image](media/Lookup_03-MRU_Entity_Images_56[1].png "Lookup fields shows image")  
+  > ![Browse a lookup field](media/MRU.png "Browse a lookup field")  
 
+## Browse in a lookup field
+To browse a lookup, select the lookup icon (magnifying glass). A full list of items will be shown in the dropdown.
 
-When you select the lookup icon (magnifying glass) or the text box, it shows the same list of most recently used records.
+  > [!div class="mx-imgBorder"]
+  > ![Search a lookup field](media/MRU_1.png "Search a lookup field")  
+ 
+## Most recently used record type images
+The most recently used list of records shows an image to help distinguish between record types.
 
   > [!div class="mx-imgBorder"]
-  > ![Recently used records](media/ConsistentEntry[1].gif "Recently used records")  
-  
+  > ![Lookup fields shows image](media/Lookup_03-MRU_Entity_Images_56[1].png "Lookup fields shows image")  
   
+## Record type selection list  
 When results span multiple record types, you can see how many types of records there are and select them from the list.
 
   > [!div class="mx-imgBorder"]
   > ![See how many records](media/Lookup_04-MultipleEntityTypes[1].gif "See how many records")  
+  
+## Create a new record if you don’t find an existing record
+
+If you do not find a record, select **New** in the lookup area to create a new record.
+
+
+### Replace an existing record from a lookup field
+
+You can replace an existing record while using simple and regarding-type lookups. Search for a record. Then select the record, and replace it with a new record.
+
+### Change a view in a lookup field 
+
+Selecting **Change View** lets you determine:
+ - How you want to view records such as **Contacts Being Followed**, **Contacts Lookup View**, or **Active Contacts**.
+ - What you want to view in the records, such as name, email, or telephone number. For example, if you want to view only the contacts that you follow, select
+    **Change View** \> **Contacts being followed**. Only the contacts that you are following will be displayed, as illustrated here. 
+
+    ![Change view contacts types](media/change-view.png "Change view contacts types")
+
+>[!IMPORTANT] 
+>The **Change View** option will not be visible if your administrator hasn't configured the option to appear in your views.
+
+### Choose from multiple records
+
+When lookup has more records in a field than can fit in the available display area, the display area is collapsed—that is, the records that do fit the display area are shown next to the number of records that are not shown. To view all records, select the number. The following images show the difference between collapsed and non-collapsed fields.
+
+**Collapsed:**
+
+![Collapsed multi-lookup display area](media/collapsed-multi-lookup-display-area.png "Collapsed multi-lookup display area")
+
+
+**Non-collapsed:**
+
+![Non-collapsed multi-lookup display area](media/non-collapsed-multi-lookup-display-area.png "Non-collapsed multi-lookup display area")