Enhance your widget

This guide includes details for optional widget enhancements that are straightforward to implement and improve your users' widget experience.

Add a name to your widget

Widgets need to have a unique name when they are displayed in the widget picker.

Widgets' names are loaded from the label attribute of the widget's receiver element in the AndroidManifest.xml file.

<receiver
    ….
   android:label="Memories">
     ….
</receiver>

Add a description for your widget

Starting in Android 12, provide a description for the widget picker to display for your widget.

A widget picker showing a widget and its description
Figure 1. Sample widget picker showing a widget and its description.

Provide a description for your widget using the description attribute of the &lt;appwidget-provider&gt; element:

<appwidget-provider
    android:description="@string/my_widget_description">
</appwidget-provider>

You can use the descriptionRes attribute on previous versions of Android, but it is ignored by the widget picker.