Home » Android » android – 'Missing contentDescription attribute on image' in XML

android – 'Missing contentDescription attribute on image' in XML

Posted by: admin March 10, 2020 Leave a comment


I get an warning about [Accessibility]Missing contentDescription attribute on image in eclipse. This warning show at line 5 (declare ImageView) in XML code below.

This not make any error when build and run my application. But I really want to know why i get this warning.

This is my XML file:

<?xml version="1.0" encoding="utf-8"?>
<LinearLayout xmlns:android="http://schemas.android.com/apk/res/android"


Please help me regarding this and thanks for your reading.

How to&Answers:

Follow this link for solution: Android Lint contentDescription warning

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 the 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

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.

This link for explanation: Accessibility, It’s Impact and Development Resources

Many Android users have disabilities that require them to interact
with their Android devices in different ways. These include users who
have visual, physical or age-related disabilities that prevent them
from fully seeing or using a touchscreen.

Android provides accessibility features and services for helping these
users navigate their devices more easily, including text-to-speech,
haptic feedback, trackball and D-pad navigation that augments their
experience. Android application developers can take advantage of these
services to make their applications more accessible and also build
their own accessibility services.

This guide is for making your app accessible: Making Apps More Accessible

Making sure your application is accessible to all users is relatively
easy, particularly when you use framework-provided user interface
components. If you only use these standard components for your
application, there are just a few steps required to ensure your
application is accessible:

  1. Label your ImageButton, ImageView, EditText, CheckBox and other user
    interface controls using the android:contentDescription attribute.

  2. Make all of your user interface elements accessible with a directional
    controller, such as a trackball or D-pad.

  3. Test your application by turning on accessibility services like TalkBack
    and Explore by Touch,
    and try using your application using only directional controls.


Add android:contentDescription="@string/description" (static or dynamic) to your ImageView.
Please do not ignore nor filter the message, because it is helpfull for people using alternative input methods because of their disability (Like TalkBack, Tecla Access Shield etc etc).



As pointed out in the comments, setting the description to null indicates that the image is purely decorative and is understood as that by screen readers like TalkBack.

Old answer, I no longer support this answer:

For all the people looking how to avoid the warning:

I don’t think android:contentDescription="@null" is the best solution.

I’m using tools:ignore="ContentDescription" that is what is meant to be.

Make sure you include xmlns:tools="http://schemas.android.com/tools" in your root layout.




to your image. Make sure you have xmlns:tools="http://schemas.android.com/tools"
in your root layout.


The warning is indeed annoying and in many (most!) cases no contentDescription is necessary for various decorative ImageViews. The most radical way to solve the problem is just to tell the Lint to ignore this check. In Eclipse, go to “Android/Lint Error Checking” in Preferences, find “contentDescription” (it is in the “Accessibility” group) and change “Severity:” to Ignore.


If you don’t care at all do this:


Although I would advise the accepted solutions, this is a hack 😀


Going forward, for graphical elements that are purely decorative, the best solution is to use:


This makes sense if your min SDK version is at least 16, since devices running lower versions will ignore this attribute.

If you’re stuck supporting older versions, you should use (like others pointed out already):


Source: https://developer.android.com/guide/topics/ui/accessibility/apps#label-elements


This warning tries to improve accessibility of your application.

To disable missing content description warning in the whole project, you can add this to your application module build.gradle

android {


    lintOptions {
        disable 'ContentDescription'