---
title: "searchbar · RUAL Documentation"
description: "Searchbar component able to search through a storage in the backend"
canonical: https://docs.rual.nl/block-types/Component%20UI/component_searchbar
language: en
---

[Cluster](https://docs.rual.nl/cluster)

[Blocks](https://docs.rual.nl/block-types)

[Interfaces](https://docs.rual.nl/interfaces)

[Blueprints](https://docs.rual.nl/blueprints)

[Tutorials](https://docs.rual.nl/tutorials)

[Home automation](https://docs.rual.nl/home-automation)

[Examples](https://docs.rual.nl/examples)

[Reference](https://docs.rual.nl/reference)

[Architecture](https://docs.rual.nl/architecture)

[Troubleshooting](https://docs.rual.nl/troubleshooting)

Other

# searchbar

This block is part of the [`Component UI`](https://docs.rual.nl/block-types/Component%20UI) group and was last modified in core [`v12.0.7`](https://docs.rual.nl/core-versions/120007).

Searchbar component able to search through a storage in the backend

- Storage required `storage` The storage to search through • Hidden when other fields are filled

- List required `array` An array with objects to search through. • Hidden when other fields are filled

- Visible Field required `fielddefinitions` Field that will be selected from the row as an input value

- Stored Field required `fielddefinitions` Field to save the selected fields in. It will be an object of the row that was selected by the user

- Fields To Select required `fielddefinitions` Fields to select from the row to save in the form

- search fields `v12.0.7` `fielddefinitions` Fields to search through

- Validate `v10.4.54` `fieldvalidation` Applies the given validation to the element, overwrites attributes given in the attributes popup. As the searchbar can store multiple values, only the required will be checked

- Query `query` Query that will be applied by default. This can be used to restrict what the user can search for. • Hidden when other fields are filled

- Event `inputevent`

- Row render `v10.4.52` `inpinfunction`

- Disable Dropdown `condition` disables the dropdown being shown

- uicomponent `uicomponent`

A typical wiring for [searchbar](https://docs.rual.nl/block-types/Component%2520UI/component_searchbar): [selector](https://docs.rual.nl/block-types/globals/storage) feeds the `co-storage` pin; [with values](https://docs.rual.nl/block-types/array/array_of_values) feeds the `listitems` pin; [combine](https://docs.rual.nl/block-types/fields/fielddefinitions_multiple) feeds the `co-fields-visible` pin; [combine](https://docs.rual.nl/block-types/fields/fielddefinitions_multiple) feeds the `co-fields-key` pin; [combine](https://docs.rual.nl/block-types/fields/fielddefinitions_multiple) feeds the `co-fields-selection` pin; the function out pin wires to an [execute](https://docs.rual.nl/block-types/function%2520execution/function_custom_execute_from_trigger) block.

[![Studio canvas example for the searchbar block: typical wiring for searchbar.](https://docs.rual.nl/canvas-examples/component_searchbar.png)](https://docs.rual.nl/canvas-examples/component_searchbar.png?v=3)

## Version history

Introduced in [`v12.0.7`](https://docs.rual.nl/core-versions/120007).

- [v11.3.0](https://docs.rual.nl/core-versions/110300): This block or one of its pins was updated in `v11.3.0`, click here to see the release notes.

- [v10.4.54](https://docs.rual.nl/core-versions/100454): This block or one of its pins was updated in `v10.4.54`, click here to see the release notes.

- [v10.4.52](https://docs.rual.nl/core-versions/100452): This block or one of its pins was updated in `v10.4.52`, click here to see the release notes.

- [Back to `Component UI`](https://docs.rual.nl/block-types/Component%20UI): Return to the main group to view all sub-groups

- [Back to `form`](https://docs.rual.nl/block-types/Component%20UI?group=form): Return to the group to view all blocks within this group

Was this page helpful? [Tell us what to improve](https://docs.rual.nl/support) · RUAL Docs is an integral component of the [RUAL ecosystem](https://rual.nl)