---
title: buttonLockup
framework: tvml
role: collectionGroup
path: tvml/buttonlockup
---

# buttonLockup

Creates a button that can also have a badge associated with it.

## Overview

Overview Images on buttons are often used to indicate the function of the button. Use the buttonLockup element to add a badge to the the button. Here’s an example that shows a button with the preview icon and a title. <buttonLockup>     <badge src="resource://button-preview" />     <title>Preview</title> </buttonLockup> Subelements of buttonLockup badge title Elements that Use buttonLockup organizer row

## Topics

### Valid TVML Styles

- [padding](tvml/padding.md)
- [width](tvml/element-shaping-width.md)

### Valid TVML Attributes

- [binding](tvml/binding.md)
- [prototype](tvml/prototype.md)
- [theme](tvml/theme.md)

## See Also

### Lockup Elements

- [button](tvml/button.md)
- [listItemLockup](tvml/listitemlockup.md)
- [lockup](tvml/lockup.md)
- [monogramLockup](tvml/monogramlockup.md)
- [overlay](tvml/overlay.md)