---
title: "autocomplete single value · RUAL Documentation"
description: "Generates auto-complete select searching a storage and filling the state with the search-key. The field will be used as state key."
canonical: https://docs.rual.nl/block-types/state%20ui/state_autocomplete_single_field
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

# autocomplete single value

This block is part of the [`state ui`](https://docs.rual.nl/block-types/state%20ui) group and was last modified in core [`v13.0.4`](https://docs.rual.nl/core-versions/130004).

## Storage Selection Required

This block relies on a storage to perform its storage releated actions. You must manually select the storage you want to use in your flow using the storage selector modal. To access the modal, click the white button on the block.

## Field Selection Required

This block relies on a field that you select to perform its data actions. You must manually select the field you want to use in your flow using the field selector modal. To access the modal, click the white button on the block.

Generates auto-complete select searching a storage and filling the state with the search-key. The field will be used as state key.

- form id required `value` A unique ID for the form this field is used in.

- storage field required `fielddefinitions` Field to select and view within the given results.

- show searchbar `condition` Enables searchbar in the dropdown.

- query `query` A query to filter the data that can be found using this searchbox.

- rows `v13.0.7` `number` The dropdown has this quantity of items in it, if it is lower than quantity found items load more button is shown. Default is 10.

Default `10`

- return fields `v13.0.8` `fielddefinitions` Fields that will be returned during the search. Should be set if the data sent to the frontend should be limited due to confidential fields.

Default `Storage fields`

- class `uiclass` Assigns a CSS class to the element. • Hidden when unused

- style `uistyle` Applies inline CSS style to the element • Hidden when unused

- attributes `uiattributes` Adds custom attributes to the element. • Hidden when unused

- state `state` Returns the element to the frontend state.

- Map Row `v13.0.8` `execute_function` The function will be executed for each row and state pins can be returned to overwrite whats visible.

- Row Component `iteratestate` The component will be executed for every row and replace the default value. A `div` should be returned. The available parameters are `row` and `index`.

A typical wiring for [autocomplete single value](https://docs.rual.nl/block-types/state%2520ui/state_autocomplete_single_field): [value](https://docs.rual.nl/block-types/value/value_default) feeds the `form_id` pin; [combine](https://docs.rual.nl/block-types/fields/fielddefinitions_multiple) feeds the `field` 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 autocomplete single value block: typical wiring for autocomplete single value.](https://docs.rual.nl/canvas-examples/state_autocomplete_single_field.png)](https://docs.rual.nl/canvas-examples/state_autocomplete_single_field.png?v=3)

## Version history

Introduced in [`v13.0.8`](https://docs.rual.nl/core-versions/130008).

Last modified in [`v13.0.4`](https://docs.rual.nl/core-versions/130004).

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

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

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

- [Back to `state elements`](https://docs.rual.nl/block-types/state%20ui?group=state%20elements): 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)