Use this dialog box to add a new search setting. This includes designing how you want the search results to look on the page.

Model	A list of available models for you to select from. The data in the selected model will be made available in search results.
Title	This is the model name selected by default but you can change this.

Choose data

Filter data items	Expands the view so you can select the conditions you want to filter the content by.
Sort data items	Expands the view so you can select the order you want to sort the properties by.

Filter data items

Property	The list of properties in the selected model.
Criteria	The list of criteria might change depending on the type of property you select, for example, text or data-based.
Value	This dynamic field changes depending on the property type you selected and the criteria.

Sort data items

Property	The property you want to sort the search results by.
Order	Either Ascending or Descending.

Design list

You can use many of the similar features available when you design a list block on a page.

Realtime preview	Shows how the search results appear after you configure your options.
Layouts	How you want your list to be laid out: Row Grid Mini-grid Map You need to set the Google Maps API Key on the Settings page. See our knowledge base article, Configure your Google Maps API key. Timeline To use the timeline, you need to sort your data items by date in the order you want.
Default layout	If you select more than one layout, you need to select which layout to show by default. Users can switch between the layouts.
Features	Elements you want in your search results. When you select the feature, additional fields appear: Text Avatar / icon / image Primary action
Show item count	This field appears after any feature fields that appear as a result of selecting the feature from the Features list. It shows the number of results in the search.

Features

Text

Title	The prominent text that shows the item in your list. For example, in a Directory, you could choose the First and Last name properties.
Subtitle	Less prominent text, which appears under the title text. For example, in a Directory, you could choose the Email address.
Overline	Less prominent text that appears above the title text. For example, in a Directory, you could choose Job role.
Action text	Less prominent text appears in the top-right corner of the item block. For example, choosing "Created" or "Updated" from the list shows in days how long ago the record was created or updated.

Avatar / icon / image

Style	The type of image you want to show for each record. Avatar - An avatar is an image or an icon that represents a person or object, and it renders as a rounded shape. Image - An image is similar to an avatar in that it is a visual representation of a person or object, but renders as a square on grid layouts, not on rows or mini-grids. Icon - An icon is a simple illustration of an object, and you can use this where avatars or images are unnecessary, or where avatars or images are unavailable.
Image property	A list of available image properties in your model. The property you choose shows the images attached to each record. For example, you might have a list of people with their photo uploaded.
Placeholder text	A list of available properpeties available in your model to show in place if the image is missing from the record. For example, you could have a property for the person's initials that appears in the circle where the image would appear if there is no image for that user.
Icon property	A list of available icons available to choose from. For example, you could choose an icon to represent a policy in a list of HR policies.
Icon color property	The color of the icon chosen for the record shown.
Use a badge	This indicates that you want to use a small colored circle to depict a status.
Badge color property	Indicates the color of the badge shown on the avatar or icon.

Primary action

The primary action is when you select the record itself. You can have it open an Applaud cloud page or an external hyperlink, either in a dialog box or on a new page. For example, you could create a list of records and to edit the records you could select the record to open a form in a dialog box.

Applaud sets these for standard models automatically, for example, the Task model.

Applaud Cloud Page

Page	The list of available pages in your Applaud tenant.
Link target	The list of available actions. In the current window In a new window In a modal

External Hyperlink

Hyperlink	The available list of properties.
Link target	The list of available actions. In the current window In a new window In a modal

Secondary actions

The secondary actions appear inside of the individual item, in the form of three dots that open additional actions. For example, clicking the three dots may present you with an option to edit the item, delete the item, view full details, etc.

Use a menu for actions

Choose a menu	The list of available menus linked to the model that you can use as your secondary actions.
Title	The label for your action link or button.
Type of action	Open page - regular - Adds a link that opens a selected page from your Applaud tenant and opens it in the same browser tab.. Open page - modal - Adds a link that opens a selected a page from your Applaud tenant and opens it in a dialog box. Toggle Boolean - Adds a link that changes a yes or no property on your model. Delete - Adds a button that deletes the whole record and its values from the model.
Target	A list of pages you can select to open when the user selects the secondary action label.
Icon	The icon you want to appear on the secondary action button or link.
Hide/show based on model property	The property you want the item to have to meet the condtion.
Condition	Either Hides or shows the record depending on the option you choose.

Chips

Chips are small blocks of color that sit within your item to illustrate an action. For example, you might include a chip on a leave request to illustrate whether it's a paid leave type or not. It's good practice to use chips to highlight exceptions rather than norms, for example, for a leave type, it would be more likely to have a chip to represent 'unpaid' rather than 'paid' as 'unpaid is less usual.

Property	A boolean property.
Condition	You can make the chip appear if the boolean property is either true or false.
Text	The text you want to appear on the chip.
Color	The color of the chip.
Icon	The icon you want to appear before the text on the chip.

Stepper

The stepper feature presents a visual process flow of steps and their status. For example, for a job application process, you may use a stepper to illustrate the process of applying, pending, reviewing, accepting/rejecting, and offering.

Active step property	This is the property you want to be the stepper to be based on. In this example, we have a property called, "Onboarding status."
Step id	This is the value the property must be for this step to be highlighted as in progress. Any previous steps are shown as done and any future steps are shown as not started. In this example, we have set the property value to "new." You can configure a workflow to update the status.
Step title	This is not linked to the property value it is whatever you want to show as the step title, shown below the step.
Step text property	This is another property you can configure to show the value in the step circle. The circle can only show three characters or digits. This is replaced by a checkmark once the step has been completed.
Mask future steps	Hides the title and text of future steps.

Searching, sorting, and filtering

The searching, sorting, and filtering feature allows you to provide the user with options to search and filter results themselves within a list block.

Searching

Lets your users search on terms that aren't necessarily shown.

Search within extra properties	Displays the Search properties option so you can configure a search function for the list.
Search properties	A list of properties for the model.

Sorting

Show sorts that allows the user to search the list items.	Displays the Property and Type options so you can configure a sort function for the list.
Property	The property you want the user to be able to filter the results by.
Type	The type of filter you want the user to be able to filter the results by.

Filtering

This doesn't apply to the map and hierarchical layouts.

Show filters that allow the user to refine the list of items	Displays the Property and Type options so you can configure a filter for the list.
Property	The property you want the user to be able to filter the results by.
Type	The type of filter you want the user to be able to filter the results by.

On-screen guidance

The on-screen guidance is the text that appears above the list to add some context to the user on what they are viewing.

Preamble	Help text to appear above your list items.
No items text	The text you want to appear when no items are returned in the search.

Design Sub list

A sublist is a list inside a list. For example, you may have a business goal as your main list, and inside that list is a series of comments about the individual's performance on that one goal. Before you can use a sub-list, you need to have another model that is related to your main list model in some way.

Sub list model
Layout	The default is row and you can't amend this.
Features	You can configure the same features for a sublist as you do for this search setting. See the rest of this article for help for each section: Text Avatar / icon / image Primary action Secondary actions Chips Stepper
Sort sub list data items	Displays the Property and Order options so you can sort the sublist items.
Property	The property you want to sort by.
Order	The order you want to sort the property value by.

Form

Embed a simple form in each list item to show a small number of form fields that allow direct updating of the model

Form block

Select a form you have already created.

General content settings

Action buttons

Title	The button label.
Type of action	How you want the link to open: Open page - Loads the Target list with pages from your Applaud tenant. URL - You need to type in the full website address in the Target box. Regular / Same tab - Takes the user away from the current page to the new page. Modal - Keeps the user on the page but opens a dialog box with the new page contained in it. New tab - Opens a new tab in the user's browser with the new external website.
Target	A list of pages in your Applaud tenant or a box where you can type in the full URL address, for example, https://www.google.com.
Icon	A list of icons you can select to appear on the button.
Color	The color of the button.
Weight	How you want your button to appear: Normal - The button appears with a colored rectangle background with black text. Light - The button doesn't have a background, and the text is the color you selected.

Show the title and header bar	Displays the title and header bar by default. Clear this option to hide them.
Preferred width	The width of the search results for the model: Automatic - Spans the width of the column on the page depending on what page layout option you have selected. Full-width - Spans the width of all columns but doesn't go beyond the margins on either side of the page unless you select the Edge-to-edge option. Two-third - If you have a three-column page layout, this spans across two of the columns. If you have a two-column page layout set, this spans just beyond the first column, but further blocks won't appear above the advert in the second column, only below it. Half-width - If you have the three-column page layout, this spans across a column and a half. If you have a two-column page layout, this spans one column.
Background color	Opens the color picker so you can select any color you want. This sets the background color of the search result list for this model.
Hide on	A list of devices where you want these search results for the model to be hidden.
Hide or show this block using filters	Displays the Conditions section. These hide or show search results by adding custom filters.

Conditions

This section appears when you select the Hide or show this block using filters option.

Property	The list of properties in the selected model.
Criteria	The list of criteria might change depending on the type of property you select, for example, text or data-based.
Value	This dynamic field changes depending on the property type you selected and the criteria.

Export

Enable

Expands the view to display the Exportable properties option so you can configure your export action.

Exportable properties

Only appears once you select the Enable option. You can choose how you want the properties exported:

All accessible - When a user selects Export, all the model properties are exported.
Use a filter to restrict the exportable properties - Displays the Properties filter option. When a user selects Export, only the selected properties are included in the exported file.

Properties filter

Appears when you select the "Use a filter to restrict the exportable properties" option from the Exportable properties setting. It's the property you want the user to be able to export.

Sections in this article