Repository navigation
Heading is not defined for ‘Breakfast’ text. #5748
Description
Is it an issue related to Adaptive Cards?
Yes, this is related to Adaptive Card. However, it does not repro on Adaptive Cards Designer.
What is the PWD impact?
When the “Breakfast” text is not defined as a heading, screen reader users and those relying on structured navigation cannot understand the hierarchy of the page. They may miss that “Breakfast” is a section title, making it harder to skim or jump directly to that content.
What browsers and screen readers do this issue affect?
Windows: Edge with Windows Narrator
Are there any code-based customization done to Web Chat?
No, I am using Web Chat without any customizations except "styleOptions".
What version of Web Chat are you using?
Latest production
Which area does this issue affect?
Others or unrelated
What is the public URL for the website?
No response
How to reproduce the issue?
Repro Steps:
- Open URL: Web Chat in edge browser.
- Ask query 'Card Breakfast'.
- Navigate to message.
- Observe the issue that Heading is not defined for ‘Breakfast’ text.
What do you expect?
Heading should be defined for ‘Breakfast’ text.
What actually happened?
Heading is not defined for ‘Breakfast’ text.
Do you have any screenshots or recordings to repro the issue?
Heading.is.not.defined.for.Breakfast.text.mp4
Did you find any DOM elements that might have caused the issue?
No response
MAS reference
No response
WCAG reference
https://www.w3.org/WAI/WCAG21/Understanding/info-and-relationships
WAI-ARIA reference
No response
Adaptive Card JSON
Additional context
No response
Activity
OEvgeny commentedon Oct 21, 2026
Thanks for the report and the recording.
In the mock bot's "Breakfast" card, "Breakfast" is a regular
TextBlock(size: Large) without astyle. Adaptive Cards does not turn large or bold text into a heading by itself; aTextBlockbecomes a heading only when the card sets"style": "heading"(Adaptive Cards 1.5). Web Chat then renders it as a level-2 heading, because level 1 is reserved for the host page (#4747). We rendered the card with"style": "heading"on thatTextBlockin the latest build, in the default and Fluent themes, and Edge exposesheading "Breakfast", level 2 (WCAG 1.3.1).To get a heading, the bot's card (MockBot's
Cards/1.0/Breakfast.ts) should set"style": "heading"on thatTextBlock, ideally with the cardversionraised to1.5.We propose to close this issue as content (bot card).