Lookups allow you to store a table of content that can be looked up against in a form.
Lookups can also be used to query content external to the platform, for more information on that, check out the Dynamic Lookups article.
Creating a Lookup
Navigate to the Lookup menu in the Advanced Tools section, and click the plus button in the bottom right of the screen.
Give your lookup a name and click Save. Now click Edit to start creating your Lookup.
Now you are going to want to start creating your lookup table, lookups consist of Rows and Columns. The rows are the values that the user will be looking up in the form, and the columns will represent the element that will be pre-filled with content. In the example below, I have created a Lookup table for different dog breeds. The row of Values is the breed of the dog, the height, and weight represent the elements on my form that I want to populate when a specific dog breed is selected. In the example below, when chihuahua is selected, the height will pre-fill to 15-22 cm and the weight will pre-fill with 1.4-2.7 kg.
Now let's configure the form. First, we will create our lookup element in the example below, which is the “Dogs” element. Since we are using a select element type, all List values (e.g. chihuahua, pekingese) will need to match the values in our lookup table. Next, we need to create our content elements, we need to ensure that the element names match our column names in the lookup table, in this example that is “height” and “weight”.
Now we are ready and can turn on the lookup, select your lookup element, in this case “Dogs” and scroll down to the Advanced section of the element details. Turn on “Enable Data Lookup” and select our Lookup.
Now we can run our lookup by either opening the preview or opening the form URL. Select an option in the lookup element and see the lookup run.
Import from elements
This action gives you the ability to automatically generate columns in your lookup table by selecting an existing form in your environment and allowing you to select the elements you would like to import. This will greatly help streamline the creation of your lookup table and remove potential naming issues.
Import rows from list
This action gives you the ability to automatically generate rows in your lookup table by selecting an existing list in your environment. Once you select the list, you can then choose which list items you want to add to your lookup.
Instead of creating the lookup table by importing rows and columns and then entering all the content in, you can instead upload an existing CSV to automatically create your lookup. Click the Upload from CSV action and then select the CSV you want to upload. Note these CSVs will need to be in the correct format in order to be uploaded, see the Dogs example attached to this article for an example.
You can also download the lookup as a CSV, by clicking the Download CSV button. This then allows you to customise the CSV within your favourite spreadsheet editor and then upload the changes to the platform.
Lookup Known Limitations
Supported Element Types
Lookups currently only support text-based values and content. Meaning elements that are able to be looked up and populated with data include: Text, Multi-line Text, Email, Phone Number, Barcode Scanner, Radio Button, Select, and Autocomplete.
If you have any questions or would like assistance with setting up your Lookups, please contact us via this support portal or email firstname.lastname@example.org. We are happy to assist in any way we can.
Was this article helpful?
Thank you for your feedback
Sorry! We couldn't be helpful
Thank you for your feedback
We appreciate your effort and will try to fix the article