Provide valid labels for search field on Android


Location: Native Android - Find courses view
Severity: 8

Description: The Search edit field that is displayed when activating the Search button is not explicitly labelled. The placeholder text is rendered as the label and when user starts typing the value is rendered without a label. The placeholder text is not meaningful and is not the accessible name for the control.

Auditor Note: Developers must ensure that a label is provided for all form controls. In this case, the edit field must be rendered as the "Search edit box".

Internal Note: On iOS, there is a page header, called Find Courses and the search field has an accessible name of Search. Ideally, Android would be similar. At the very least, can we make the placeholder text something meaningful instead of clever, like Find courses, or Search, or Search for courses, and make the accessible name for the field match whatever theplaceholder text is?

Acceptance Criteria:

  • There must be meaningful a11y content for Search edit field for Course Discovery screen.

  • There must be meaningful place holder hint text for Search edit field for Course Discovery screen.

  • Old a11y content/placeholder text for other languages should be removed as well.

Epic Link


Albert (AJ) St. Aubin
November 21, 2017, 2:26 PM

I agree with both of those. Lets go with "Search for courses".

Farhan Khan
November 21, 2017, 1:59 PM

In Android native Search widget, we can't set different content for placeholder text (hint) and accessibility content, so we got to go for last resort that is using common content for both which have to finalize.
Mark's suggestions "Find courses" or "Search for courses" both seems fine to me.

Current search view:

cc: , ,

Marco Morales
October 26, 2017, 5:05 PM

This may have changed slightly since the release of the latest build. We should ensure we have the appropriate labels to the search icon now rendered on the Courses area. cc'ed

Your pinned fields
Click on the next to a field label to start pinning.




Farhan Khan



Story Points



Mark Sadecki