<!--
{
  "documentType" : "article",
  "framework" : "TVML",
  "identifier" : "/documentation/TVML/searchfield",
  "metadataVersion" : "0.1.0",
  "role" : "collectionGroup",
  "title" : "searchField"
}
-->

# searchField

Displays an interactive text field used to search for content.

## Overview

The `searchField` element creates a text field for user input. Different keyboards
can be used to provide the best input experience for the user. Here’s an example
that presents a search field along with three movies.

```xml
<searchTemplate>
    <searchField/>
    <shelf>
        <header>
            <title>Popular</title>
        </header>
        <section>
            <lockup>
                <img src="path to images on your server/Car_Movie_250x375_A.png" width="182" height="274" />
                <title>Movie 1</title>
            </lockup>
            <lockup>
                <img src="path to images on your server/Car_Movie_250x375_B.png" width="182" height="274" />
                <title>Movie 2</title>
            </lockup>
            <lockup>
                <img src="path to images on your server/Car_Movie_250x375_C.png" width="182" height="274" />
                <title>Movie 3</title>
            </lockup>
        </section>
    </shelf>
</searchTemplate>
```

### Contained In

- [searchTemplate](/documentation/TVML/searchtemplate)
- [stackTemplate](/documentation/TVML/stacktemplate)

## Topics

### Valid TVML Attributes

[binding](/documentation/TVML/binding)

Associates information in a data item with an element.

[keyboardType](/documentation/TVML/keyboardtype)

Specifies the keyboard to display.

[prototype](/documentation/TVML/prototype)

Associates a data item type with an element.

[showSpinner](/documentation/TVML/showspinner)

Displays a rotating spinner icon inside of a search field.

[theme](/documentation/TVML/theme)

Sets the color scheme for an element.



---

Copyright &copy; 2026 Apple Inc. All rights reserved. | [Terms of Use](https://www.apple.com/legal/internet-services/terms/site.html) | [Privacy Policy](https://www.apple.com/privacy/privacy-policy)