Widgets are customizable home screen elements that display a clear and
actionable view of an app's content or actions. This content can periodically
refresh.

Widgets help users complete their goals, either by interacting with your app's
content directly in the widget or by opening your full app experience.
![](https://developer.android.com/static/images/design/ui/mobile/widgets/GettingStarted_Header.jpg)

## Get started

When creating your widget, complete the following steps:

1. Choose a single primary user case to highlight in your widget.
2. Check out the [Widget template examples](https://www.figma.com/community/file/1237551184114564748/android-ui-kit) on Figma.
3. Design the UI within the [sizing](https://developer.android.com/design/ui/mobile/guides/widgets/sizing) guidelines.
4. Test for multiple screen sizes.
5. Ensure your widget meets the [Widget quality guides](https://developer.android.com/docs/quality-guidelines/widget-quality).

### Canonical widget layouts

Layouts dictate how information and interactive elements are organized within your widget. Learn more about prebuilt layouts for text, list \& grid-type widgets.  
[Learn more](https://developer.android.com/design/ui/mobile/guides/widgets/layouts)  

### Sizing

Learn more about designing widgets that scale seamlessly to multiple sizes. See the default widget sizes and learn how to fully use the grid space given.  
[Learn more](https://developer.android.com/design/ui/mobile/guides/widgets/sizing)  

### Style

Learn how to style your widget to enhance your widget's visual impact and to fit with the user's device theme.  
[Learn more](https://developer.android.com/design/ui/mobile/guides/widgets/style)  

### Discovery and promotion

Learn to promote your widget on the widget picker through appropriate sizing and information shown.  
[Learn more](https://developer.android.com/design/ui/mobile/guides/widgets/discovery-promotion)