1. Get started with Accessibility Scanner
  2. How to read Accessibility Scanner results
  1. Get started with Accessibility Scanner

    When you design and develop an Android app, Accessibility Scanner can help you improve your app for users.

    Accessibility Scanner scans your screen and provides suggestions to improve the accessibility of your app, based on:

    • Content labels
    • Touch target size
    • Clickable items
    • Text and image contrast

    Important: Accessibility Scanner isn't a replacement for manual testing and doesn't guarantee the accessibility of the app.

    Step 1: Install and turn on Accessibility Scanner

    Accessibility Scanner is available for phones and tablets with Android 6.0 and up. Learn how to check your Android version.

    1. Download Accessibility Scanner from Google Play.
    2. Open Accessibility Scanner Accessibility Scanner.
    3. In your device's Settings app, follow the prompts to turn on Accessibility Scanner.
    4. Tap Accessibility and then Accessibility Scanner and then Use service.
      • To turn off Accessibility Scanner: Return to Settings and then Accessibility and then Accessibility Scanner.

    Step 2: Scan your app

    You can scan a snapshot of your app or a series of screens as you interact with your app.

    Scan a recording

    You can scan a workflow or task within your app. With this option, Accessibility Scanner records and analyses the elements on your screen as you use and navigate through your app.

    Important: The recording includes a series of screenshots, and doesn’t include video or audio. The recording stays on your device and is never shared with Google.

    To scan a recording:

    1. Open your app.
    2. Tap the Accessibility Scanner button .
    3. Tap Record Video camera.
    4. Use your app.
      • If you go to another app, the recording pauses until you return.

    To stop a recording:

    1. From the top of your screen, swipe down to open your notifications. Or, open another app.
    2. Tap Accessibility Scanner is recording.
    3. Tap Stop .

    Scan a snapshot

    To scan a single screen of your app:

    1. Open your app.
    2. Tap Accessibility Scanner .
    3. Tap Snapshot Choose image.

    Review the results of a scan

    After you scan a recording or snapshot, Accessibility Scanner displays one or more screenshots of your app. Within a screenshot, results of the scan are outlined in orange rectangles.

    • To view details: Tap the outlined area. If a screen has multiple results, tap Next Next.
    • To view a complete list of results from all the screenshots: Tap List and then View by screen or View by category.
    • To share results: Tap Share .

    If you scanned a recording or have more than one screenshot:

    • To navigate between screenshots: In the carousel at the top, tap a screenshot. Or, tap Next Next.
    • To view a grid with all the screenshots: Tap Library .

    Tip: If a resource name is too long to fit on your screen, touch and hold the resource name to marquee it.

    Scan secure windows

    If your app has a window that's declared 'secure' (using WindowManager.LayoutParams.FLAG_SECURE) Accessibility Scanner can't capture an image of the screen or check colour contrast. For these windows, after it scans your app, Accessibility Scanner shows a black screen. However, you can still read the scan results for other opportunities.

    Change contrast and touch target size thresholds

    You can change the thresholds that Scanner uses for contrast ratio and touch target size.

    1. On your device, go to the Apps section.
    2. Tap Accessibility Scanner Accessibility Scanner and then Settings Settings.
    3. View or change your settings:
      • Text contrast ratio: Set a new minimum for text colour contrast.
      • Image contrast ratio: Set a new minimum for image colour contrast.
      • Touch target size: Set a new minimum for touch target size.

    Edit contrast ratio results

    Scanner uses foreground and background colours to decide the contrast ratio. You can change the foreground or background colours.

    1. On your device, go to the Apps section.
    2. Tap Accessibility Scanner Accessibility Scanner.
    3. Tap a scan that has a colour contrast suggestion and then Edit colours.
    4. Below the screenshot, tap Foreground or Background.
    5. To change the foreground or background colour:
      • Drag the selection frame to a different area of the screenshot.
      • At the bottom, tap one of the suggested colours.
    6. Tap Apply.

    Tip: To move the selection frame, tap the arrows on the side. Or, to make larger adjustments, touch and hold the arrows.

    Share your scan results

    You can share your results with other people, like teammates.

    To share your results now:

    1. Complete a scan.
    2. Tap Share .
    3. Choose how to share your results.

    Tip: To share results for an individual item, tap Share while viewing the item.

    To share your results later:

    1. On your device, go to the Apps section.
    2. Tap Accessibility Scanner Accessibility Scanner.
    3. Tap the scan and then Share .
    4. Choose how to share your results.

    Manage past scans

    Rename a scan

    1. On your device, go to the Apps section.
    2. Tap Accessibility Scanner Accessibility Scanner.
    3. Tap a scan and then More More and then Rename title.
    4. Create a title.
    5. Tap Rename.

    Add a description

    1. On your device, go to the Apps section.
    2. Tap Accessibility Scanner Accessibility Scanner.
    3. Tap a scan and then More More and then Edit description.
    4. Add a description.
    5. Tap Save.

    Delete a scan

    1. On your device, go to the Apps section.
    2. Tap Accessibility Scanner Accessibility Scanner.
    3. Tap a scan and then More More and then Delete scan and then Delete.

    Get help or send feedback

    To get help or send feedback about Accessibility Scanner, in the app, tap Help and feedback.

  2. How to read Accessibility Scanner results

    Accessibility Scanner looks for the following opportunities to improve your app's accessibility.

    Content labelling

    Many user interface controls depend on visual cues to indicate their meaning and use. A user with impaired vision might have difficulty seeing these cues.

    You can make user interface controls more accessible with content labels. Content labels don't appear on the screen, but users with visual impairments can access them through accessibility services like TalkBack or other screen readers.

    Accessibility Scanner looks for the following content labelling opportunities:

    • Item label missing
      Identify Views that a screen reader could focus and that have an empty spoken description, either for the View or relevant Views in its sub-hierarchy. Learn more about content labels.
    • Item labelled with type or state
      Identify cases where a View has a redundant description. Learn more about items labelled with type or state.
    • Duplicate item descriptions
      Identify cases where a hierarchy contains Views with exactly duplicate descriptions. For example, two separately focusable buttons described as 'More options' could confuse a user. Learn more about duplicate descriptions.
    • Link purpose unclear
      Identify uninformative link text, such as 'click here'. Learn more about unclear link text.
    Implementation

    Accessibility Scanner examines View hierarchies and identifies instances where users with motor impairments might have difficulty interacting with a layout.

    • Clickable links
      Identify uses of ClickableSpan that aren't UrlSpans. Learn more about clickable links.
    • Duplicate clickable Views
      Identify clickable Views that share the same on-screen location as other clickable Views. Learn more about duplicate clickable Views.
    • Editable item label
      Identify EditTexts and editable TextViews that have a non-empty contentDescription. Learn more about editable View labels.
    • Unsupported item type
      Identify item types that are not supported by accessibility services. Learn more about unsupported item types.
    • Traversal order
      Identify possible issues in the traversal ordering of items, which might affect users of screen readers or other accessibility services. Learn more about traversal order.
    Touch target size

    Accessibility Scanner looks for small touch targets that could cause difficulty for users with motor impairments.

    • Touch target size
      Identify clickable and long-clickable Views that are smaller than 48x48dp in either dimension, or 32x32dp for Views within input method windows or against the display edge. You can change the minimum size in your Accessibility Scanner settings. Learn more about touch target size.
    Low contrast

    Accessibility Scanner suggests improvements to colour contrast ratios to make your app more accessible to visually impaired users.

    • Text and image contrast
      Identify text or images with a contrast ratio lower than 3.0 between the text colour and background colour (for non-empty TextViews) or between the foreground and background colour (for ImageViews). You can change the minimum ratio in your Accessibility Scanner settings. Learn more about colour contrast.

    Learn more about accessibility

    Read more in the Android Developer Accessibility documentation.