Skip to content
Material Design 2
Main Navigation
v3
v2
v1

English

简体中文
繁體中文
Español
Français
Русский
Português – Brasil
Deutsch
日本語
한국어
Italiano
Polski
Türkçe
čeština
magyar

English

简体中文
繁體中文
Español
Français
Русский
Português – Brasil
Deutsch
日本語
한국어
Italiano
Polski
Türkçe
čeština
magyar

Appearance

Sidebar Navigation

Material System

Introduction

Material studies

About our Material studies

Basil

Crane

Fortnightly

Owl

Rally

Reply

Shrine

Material Foundation

Environment

Surfaces

Elevation

Light and shadows

Layout

Understanding layout

Pixel density

Responsive layout grid

Spacing methods

Component behavior

Applying density

Navigation

Understanding navigation

Navigation transitions

Search

Color

The color system

Applying color to UI

Color usage

Text legibility

Dark theme

Typography

The type system

Understanding typography

Language support

Sound

About sound

Applying sound to UI

Sound attributes

Sound choreography

Iconography

Product icons

System icons

Animated icons

Shape

About shape

Shape and hierarchy

Shape as expression

Shape and motion

Applying shape to UI

Motion

Understanding motion

The motion system

Speed

Choreography

Customization

Interaction

Gestures

Selection

States

Communication

Confirmation & acknowledgement

Data formats

Data visualization

Empty states

Help & feedback

Imagery

Launch screen

Onboarding

Offline states

Writing

Machine learning

Machine learning patterns

Object detection: live camera

Object detection: static image

Barcode Scanning

Material Guidelines

Material Theming

Overview

Implementing your theme

Usability

Accessibility

Bidirectionality

Platform guidance

Android bars

Android fingerprint

Android haptics

Android icons

Android navigating between apps

Android notifications

Android permissions

Android slices

Android split-screen

Android swipe-to-refresh

Android text selection toolbar

Android widget

Cross-platform adaptation

Components

App bars: bottom

App bars: top

Backdrop

Banners

Bottom navigation

Buttons

Buttons: floating action button

Cards

Checkboxes

Chips

Data tables

Date pickers

Dialogs

Dividers

Image lists

Lists

Menus

Navigation drawer

Navigation rail

Progress indicators

Radio buttons

Sheets: bottom

Sheets: side

Sliders

Snackbars

Switches

Tabs

Text fields

Time pickers

Tooltips

On this page

Android widget ​

Widgets display glanceable information of an app's most important data and functionality.

Types ​

Widgets display your app’s new and interesting content in a consolidated form on a mobile home screen. They link to richer detail within the app.

Users can move and, if supported, resize widgets across their home screen panels.

Information widgets ​

Information widgets display a few elements of importance to a user and track how that information changes over time, such as weather or sports scores. Tapping the widget launches the associated app into a detail screen.

An information widget
An information widget

Collection widgets ​

Collection widgets display multiple elements of the same type, such as a collection of articles from a news app. They focus on two interactions:

  • Browsing a collection
  • Opening an element’s detail screen

Collection widgets can scroll vertically.

A collection widget
A collection widget

A collection widget
A collection widget

Control widgets ​

Control widgets display frequently used functions. These functions may be triggered from the home screen without opening the app. For example, music app widgets allow the user to play, pause, or skip music tracks from outside the music app.

Control widgets may or may not progress to a detail screen.

A control widget
A control widget

Hybrid widgets ​

Many widgets are hybrids that combine elements of the different types above. Center your widget around one of these types and add elements of others as needed.

A hybrid music player widget combines a control widget with elements of an information widget
A hybrid music player widget combines a control widget with elements of an information widget. The result keeps the user informed about which track is currently playing.

App widgets

Miniature application views that can be embedded in other applications

Related link

Behavior ​

Scrolling ​

Scrollable widgets ​

List or grid-based collection widgets usually expand or contract the vertical scrolling area. Regardless of the widget's size, the user can still scroll all elements into view.

Determine how much of your app's information should surface. For smaller widget sizes, concentrate on the essential and then add more contextual information as the widget grows.

Non-scrollable widgets ​

Information widgets are not scrollable. All content and layout must dynamically fit into the size selected by the user.

Resizing ​

Resizing allows users to adjust the height or width of a widget. This allows users to influence the layout of widgets on home panels.

Your app may be completely resizable or constrained to horizontal or vertical size changes.

A long press and subsequent release sets resizable widgets into resize mode
A long press and subsequent release sets resizable widgets into resize mode. Users can use the drag handles or the widget corners to set the desired size.

Responsive resizing ​

Widgets should accommodate different spacing requirements across devices, including cell number, size, and spacing variations.

Navigation ​

Your widgets should provide navigation links to frequently used areas of your app, including:

  • Functions that allow the user to create new content, such as a new document or message
  • Access to the top level of your app

Configuring ​

Once placed on a home screen panel, Android widgets display their configuration choices.

Configuration should:

  • Present no more than 2-3 configuration elements
  • Present choices using dialogs, rather than full-screen, to retain the user's context

Once set up, widgets do not typically show a "Setup" or "Configuration" button.

Pager
Previous pageAndroid text selection toolbar
Next pageCross-platform adaptation

Released under the Apache-2.0

Copyright © 2018-Present Google

https://m2.material.io/design/platform-guidance/android-widget.html

Released under the Apache-2.0

Copyright © 2018-Present Google