Stay organized with collections
Save and categorize content based on your preferences.
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.
Get started
When creating your widget, complete the following steps:
Choose a single primary user case to highlight in your widget.
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 about designing widgets that scale seamlessly to multiple sizes. See the default widget sizes and learn how to fully use the grid space given.
Content and code samples on this page are subject to the licenses described in the Content License. Java and OpenJDK are trademarks or registered trademarks of Oracle and/or its affiliates.
Last updated 2025-05-13 UTC.
[[["Easy to understand","easyToUnderstand","thumb-up"],["Solved my problem","solvedMyProblem","thumb-up"],["Other","otherUp","thumb-up"]],[["Missing the information I need","missingTheInformationINeed","thumb-down"],["Too complicated / too many steps","tooComplicatedTooManySteps","thumb-down"],["Out of date","outOfDate","thumb-down"],["Samples / code issue","samplesCodeIssue","thumb-down"],["Other","otherDown","thumb-down"]],["Last updated 2025-05-13 UTC."],[],[],null,["# Widgets are customizable home screen elements that display a clear and\nactionable view of an app's content or actions. This content can periodically\nrefresh.\n\nWidgets help users complete their goals, either by interacting with your app's\ncontent directly in the widget or by opening your full app experience.\n\nGet started\n-----------\n\nWhen creating your widget, complete the following steps:\n\n1. Choose a single primary user case to highlight in your widget.\n2. Check out the [Widget template examples](https://www.figma.com/community/file/1237551184114564748/android-ui-kit) on Figma.\n3. Design the UI within the [sizing](/design/ui/mobile/guides/widgets/sizing) guidelines.\n4. Test for multiple screen sizes.\n5. Ensure your widget meets the [Widget quality guides](/docs/quality-guidelines/widget-quality).\n\n### Canonical widget layouts\n\nLayouts dictate how information and interactive elements are organized within your widget. Learn more about prebuilt layouts for text, list \\& grid-type widgets. \n[Learn more](/design/ui/mobile/guides/widgets/layouts) \n\n### Sizing\n\nLearn 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. \n[Learn more](/design/ui/mobile/guides/widgets/sizing) \n\n### Style\n\nLearn how to style your widget to enhance your widget's visual impact and to fit with the user's device theme. \n[Learn more](/design/ui/mobile/guides/widgets/style) \n\n### Discovery and promotion\n\nLearn to promote your widget on the widget picker through appropriate sizing and information shown. \n[Learn more](/design/ui/mobile/guides/widgets/discovery-promotion)"]]
