Search Widget

The Search widget adds a search field to the app. Users can search for pages in the current applet, applets in the app, or run a free-text search across everything searchable.

When to use this

• You want to give users a quick way to find pages in an applet
• You need to search across all applets in an app
• You want a global free-text search that searches everywhere

How it works

You pick Search for to control what the search targets — pages in the current applet or all applets in the app. Turn on Free text search to search all searchable content instead, which locks the target choice. You also control where the field is placed (on the page or in the header) and how each result is displayed in the list.

Add a search field

1. Open the Design editor for your applet.
2. Add the Search widget to the page.
3. Open the widget settings.
4. Configure Search for, Placement, and Display options.
5. Adjust the placeholder and the no-results text.

Widget settings

Searchbar settings

Setting	Description
Icon	Pick the icon shown in the search field.
Search for	Pick Page (searches pages in the current applet) or Applet (searches all applets in the app). Disabled when Free text search is on.
Placeholder	The text shown in the empty search field.
Text for no results	The text shown when the search returns no matches.
Placement	Pick On page (the search field is shown where the widget sits) or In header (the search field is shown in the app header).
Free text search	Enables broad free-text search across all searchable content. When on, Search for is locked.

List settings

Setting	Description
Display options	Pick Name only, Name and icon, or Name and thumbnail for how each result appears in the list.

Example

Scenario: You want a global search field in the app header that lets users search across all applets.

1. Add a Search widget to the app's shared layout.
2. Set Search for to Applet.
3. Set Placement to In header.
4. Enter a placeholder — Search applets….
5. Pick Name and icon under Display options.

The header now shows a search field that searches across all applets, no matter which page the user is on.

Tips

TIP

In header placement requires the widget to live in a shared layout. If you place it on a single page, the search field only shows up there.

TIP

Use Free text search when you want a broad search over all content. For targeted searches — for example only among pages — keep Search for active.

Common mistakes

WARNING

Free text search locks Search for. To go back to a specific search target, turn free-text search off first.

WARNING

The Thumbnail option under Display options requires results to have an image — otherwise only the name shows. Use Name and icon if your pages don't have thumbnails.