You are here: Elements Reference > Search Elements > Query-by-example Element > Query by example Example

Query-by-Example Element Example

To use the Query-by-Example Element, you need to create an instance of the Element on the page that site visitors use to query the data, and also place an instance of the Element on a results page, where the results of the query will display. You should first create the results then create the page where the user will query the data, as described in the following example.

Assume that you want to create a page that allows visitors to a blog portal to search for specific blog posts by category.

First, create a page for displaying the user’s query results. (You will later return to this page to add an instance of the Query-by-example blog in order to display the results). After you have created the page, navigate to the page for generating the query to the Blog Element.

The Query-by-Example Element is accessible in the Element Gallery under Search Elements. In author mode on the page where you want the user to query the data, place it on a page, and select the simple form, custom metadata, or custom Element data you want the user to to query.

Click on the ghost text to select the Query-by-example source form, as shown below.

query by example element menu


Clicking Select Form & Fields launches the Query By Example Source dialog...

Select the simple form, custom metadata, or custom Element, and click Next to display the Select Form Fields dialog. Select the fields for users to query.

For data entered using a dropdown list, you can either display only the values for which data exists (Get option values from data) or all dropdown values (Use options from value list). In the example above, there may be more event categories in the selection list than there are actual values; you can decide whether to display all possible options, or just those containing records.


The Form Action defaults to the current page, as that is the typical configuration with the QBE and the Results residing on the same page.


Related Links

Define Query-by-example Form Action

Filtering Query-by-example Results

You can download PDF versions of the Content Contributor's, Administrator's, and Elements Reference documents from the support section of (requires login).

For technical support: