Bug
Headers or titles in ArcGIS StoryMaps are read out with the wrong header labels (h1, h2, h3...) when using a screen reader, violating WCAG guidelines of logical heading order.
| Bug ID Number | BUG-000178183 |
|---|---|
| Submitted | July 24, 2025 |
| Last Modified | August 7, 2025 |
| Applies to | ArcGIS StoryMaps |
| Version found | June 2025 |
| Operating System | Windows OS |
| Operating System Version | 11.0 64 bit |
| Status | As Designed |
Additional Information
ArcGIS StoryMap builders are designed for a broad audience, many of whom may not be familiar with basic accessibility concepts. For this reason, an intentional re-mapping exists between the “headings” created in the builder and the semantic HTML headings coded into the resulting web page for screen reader use. From the author’s perspective, it would seem inconsistent if the first heading level in the body of the story were called “Heading 2.” However, from a screen reader perspective, the first heading level in the body after the title (which must be an) must be . For this reason, the “Heading 1” displayed in the builder corresponds to in the HTML code.
The screen reader reads the intended heading hierarchy correctly because the headings are coded with the appropriate HTML elements to ensure sequential usage. Authors are advised to use the headings provided in the body of the story in a straightforward, sequential order starting with Heading 1, followed by Heading 2 and Heading 3 as needed.
A future update is planned to enhance ArcGIS StoryMaps documentation with details on how headings function with screen readers, in order to address any confusion that may arise for authors who are highly familiar with accessibility guidelines.
Steps to Reproduce
in the HTML code.
The screen reader reads the intended heading hierarchy correctly because the headings are coded with the appropriate HTML elements to ensure sequential usage. Authors are advised to use the headings provided in the body of the story in a straightforward, sequential order starting with Heading 1, followed by Heading 2 and Heading 3 as needed.
A future update is planned to enhance ArcGIS StoryMaps documentation with details on how headings function with screen readers, in order to address any confusion that may arise for authors who are highly familiar with accessibility guidelines.
Steps to Reproduce
Bug ID: BUG-000178183
Software:
- ArcGIS StoryMaps
Get notified when the status of a bug changes
Discover more on this topic
Search for related information
Find training related to this topic
Explore ideas and give feedback
Get help from ArcGIS experts
Download the Esri Support App