Home » Android » Android Lint contentDescription warning

Android Lint contentDescription warning

Posted by: admin March 11, 2020 Leave a comment


I am getting warning as
“[Accessibility] Missing contentDescription attribute on image” for imageview. while using android lint

What does that mean?

How to&Answers:

Resolved this warning by setting attribute android:contentDescription for my ImageView


Android Lint support in ADT 16 throws this warning to ensure that image widgets provide a contentDescription.

This defines text that briefly describes content of the view. This property is used primarily for accessibility. Since some views do not have textual representation this attribute can be used for providing such.

Non-textual widgets like ImageViews and ImageButtons should use the contentDescription attribute to specify a textual description of the widget such that screen readers and other accessibility tools can adequately describe the user interface.


Disabling Lint warnings will easily get you into trouble later on. You’re better off just specifying contentDescription for all of your ImageViews. If you don’t need a description, then just use:



Another option is to suppress the warning individually:

xmlns:tools="http://schemas.android.com/tools"  (usually inserted automatically)


<RelativeLayout xmlns:android="http://schemas.android.com/apk/res/android"
    tools:ignore="contentDescription" >

            android:src="@drawable/icon" />


I recommend you to add the contentDescription.


but, let’s be realistic. Most people don’t maintain literal for accessibility.
Still, with little effort, you can implement something to help people with disability.

<string name="contentDescriptionUseless">deco</string>
<string name="contentDescriptionAction">button de action</string>
<string name="contentDescriptionContent">image with data</string>
<string name="contentDescriptionUserContent">image from an other user</string>


The most important thing the blind user will need to know is “Where is the button that I need to click to continue”

Use contentDescriptionAction for anything clickable.

use contentDescriptionContent for image with information (graph, textAsImage, …)

use contentDescriptionUserContent for all user provided content.

use contentDescriptionUseless for all the rest.


Since it is only a warning you can suppress it. Go to your XML’s Graphical Layout and do this:

  1. Click on the right top corner red button

    enter image description here

  2. Select “Disable Issue Type” (for example)

    enter image description here


If you want to suppress this warning in elegant way (because you are sure that accessibility is not needed for this particular ImageView), you can use special attribute:



Non textual widgets need a content description in some ways to describe textually the image so that screens readers to be able to describe the user interface. You can ignore the property xmlns:tools="http://schemas.android.com/tools"
or define the property android:contentDescription="your description"


ContentDescription needed for the Android accessibility.
Particularly for the screen reader feature.
If you don’t support Android accessibility you can ignore it
with setup Lint.

So just create lint.xml.

<?xml version="1.0" encoding="UTF-8"?>

    <issue id="ContentDescription" severity="ignore" />


And put it to the app folder.

enter image description here


For graphical elements that are purely decorative, set their respective android:contentDescription XML attributes to “@null”.

If your app only supports devices running Android 4.1 (API level 16) or higher, you can instead set these elements’ android:importantForAccessibility XML attributes to “no”


Go to Gradle file (module app), add below code block

android {
    lintOptions {
        disable 'ContentDescription'

No more warning! happy coding


Since I need the ImageView to add an icon just for aesthetics I’ve added tools:ignore="ContentDescription" within each ImageView I had in my xml file.

I’m no longer getting any error messages