<!--
{
  "documentType" : "article",
  "framework" : "UIKit",
  "identifier" : "/documentation/UIKit/adding-user-focusable-elements-to-a-tvos-app",
  "metadataVersion" : "0.1.0",
  "role" : "article",
  "title" : "Adding user-focusable elements to a tvOS app"
}
-->

# Adding user-focusable elements to a tvOS app

Create intuitive and easily manipulated user-interactive controls for your tvOS app.

## Discussion

On Apple TV, people use a remote or game controller to navigate through interface elements like movie posters, apps, or buttons, highlighting each item as they come to it. The highlighted item is said to be *focused* or *in focus*. It appears elevated or otherwise distinct from other items. An item is considered focused when the user has highlighted it, but not selected it. The user moves focus by navigating through different UI items, which triggers a focus update.

### Add focusable items to the view

In Xcode, search the Library pane for the item you want to add to your app, and drag it to your app’s storyboard. Several UIKit elements are focusable by default, including buttons ([`UIButton`](/documentation/UIKit/UIButton)), text fields ([`UITextField`](/documentation/UIKit/UITextField)), and table cells ([`UITableViewCell`](/documentation/UIKit/UITableViewCell)). The top-left item is in focus when your app launches. (In right-to-left languages, the top-right item is initially in focus.) You don’t need to do anything to UIKit elements that are focusable by default. However, you can add SceneKit and SpriteKit nodes as focusable elements. To make a SceneKit or SpriteKit node focusable, set the <doc://com.apple.documentation/documentation/SpriteKit/SKNode/focusBehavior> property of the node to `focusable`, as shown below.

```swift
node.focusBehavior = .focusable
```

### Design your layout in a grid pattern

The easiest way to ensure that focus moves between focusable items is to arrange the items in a grid pattern. Swiping on the remote triggers the focus engine—the system that controls focus and movement—to find all of the focusable items in the direction of the swipe. The first item found then becomes the newly focused item. The following image shows the items found by the focus engine when the user swipes right, and the resulting focused item.

![Image that shows the result of swiping right on the remote.](images/com.apple.uikit/media-2923202@2x.png)

The following image shows the items found by the focus engine when the user swipes down, and the resulting focused item.

![Image that shows the result of swiping down on the remote.](images/com.apple.uikit/media-2923200@2x.png)

When the focus engine doesn’t find any items in the direction of the swipe, by default the focused item doesn’t change, as shown in the following image.

![Image that shows the result of swiping down with no items.](images/com.apple.uikit/media-2923201@2x.png)

When necessary, you can change the default behavior by using [`UIFocusGuide`](/documentation/UIKit/UIFocusGuide) to redirect focus to other focusable items in the user interface.

---

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)