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

# row

Displays elements horizontally.

## Overview

The `row` element provides the ability to place elements next to other elements horizontally.
Elements are displayed left to right in the order they are listed inside of the `row`
element. Here’s an example that places two buttons inside of a `row` element.

```xml
<row>
    <buttonLockup>
        <badge src="resource://button-preview" />
        <title>Preview</title>
    </buttonLockup>
    <buttonLockup type="buy">
        <text>$9.99</text>
        <title>Buy</title>
    </buttonLockup>
</row>
```

### Subelements of row

- [badge](/documentation/TVML/badge)
- [button](/documentation/TVML/button)
- [buttonLockup](/documentation/TVML/buttonlockup)
- [organizer](/documentation/TVML/organizer)
- [subtitle](/documentation/TVML/subtitle)
- [text](/documentation/TVML/text)

### Elements that Use row

- [banner](/documentation/TVML/banner)
- [descriptiveAlertTemplate](/documentation/TVML/descriptivealerttemplate)
- [info](/documentation/TVML/info)
- [itemBanner](/documentation/TVML/itembanner)
- [stack](/documentation/TVML/stack)

## Topics

### Valid TVML Styles

[margin](/documentation/TVML/margin)

Specifies the spacing around an element.

[tv-align](/documentation/TVML/tv-align)

Aligns an element horizontally inside its parent.

[tv-content-align](/documentation/TVML/tv-content-align)

Aligns an element vertically inside its parent element.

[tv-interitem-spacing](/documentation/TVML/tv-interitem-spacing)

Specifies the spacing between child elements.

### Valid TVML Attributes

[autoHighlight](/documentation/TVML/autohighlight)

Specifies that the element should initially be in focus.

[binding](/documentation/TVML/binding)

Associates information in a data item with an element.

[prototype](/documentation/TVML/prototype)

Associates a data item type with an element.

[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)