microsoft · cjennison · Jun 6, 2026 · Jun 7, 2026 · Jun 7, 2026 · Jun 7, 2026
@@ -19,6 +19,11 @@ Legends:
 
 ## [Unreleased]
 
+### Added
+
+- Added `styleOptions.richCardTitleOmitHeadingRole` (default `false`) to opt out of `style: 'heading'` on rich card titles, in PR [#5839](https://github.com/microsoft/BotFramework-WebChat/pull/5839), by [@cjennison](https://github.com/cjennison)
+
+
 ## [4.19.1] - 2026-06-09
 
 ### Changed

@@ -0,0 +1,4 @@
+[role='heading'] {
+  background-color: yellow !important;
+  outline: dashed 2px Red !important;
+}
@@ -2,6 +2,7 @@
 <html lang="en-US">
   <head>
     <link href="/assets/index.css" rel="stylesheet" type="text/css" />
+    <link href="heading-indicator.css" rel="stylesheet" type="text/css" />
     <script crossorigin="anonymous" src="/test-harness.js"></script>
     <script crossorigin="anonymous" src="/test-page-object.js"></script>
     <script crossorigin="anonymous" src="/__dist__/webchat-es5.js"></script>
@@ -21,12 +22,21 @@
 
         await pageObjects.sendMessageViaSendBox('herocard', { waitForSend: true });
         await pageConditions.minNumActivitiesShown(2);
+        await pageConditions.allImagesLoaded();
         await pageConditions.scrollToBottomCompleted();
 
-        expect(document.querySelector('.ac-textBlock[role="heading"]')).toHaveProperty(
-          'innerText',
-          '\u200BDetails about image 1\u200B'
+        const heroCardActivity = Array.from(webChatElement.querySelectorAll('.webchat__basic-transcript__activity')).find(
+          (activity) => !!activity.querySelector('.ac-textBlock')
         );
+        expect(heroCardActivity).toBeTruthy();
+
+        const titleTextBlock = Array.from(heroCardActivity.querySelectorAll('.ac-textBlock')).find(
+          (block) => block.innerText === '\u200BDetails about image 1\u200B'
+        );
+        expect(titleTextBlock).toBeTruthy();
+        expect(titleTextBlock.getAttribute('role')).toBe('heading');
+
+        await host.snapshot('local');
       });
     </script>
   </body>

@@ -0,0 +1,46 @@
+<!DOCTYPE html>
+<html lang="en-US">
+  <head>
+    <link href="/assets/index.css" rel="stylesheet" type="text/css" />
+    <link href="heading-indicator.css" rel="stylesheet" type="text/css" />
+    <script crossorigin="anonymous" src="/test-harness.js"></script>
+    <script crossorigin="anonymous" src="/test-page-object.js"></script>
+    <script crossorigin="anonymous" src="/__dist__/webchat-es5.js"></script>
+  </head>
+  <body>
+    <main id="webchat"></main>
+    <script>
+      run(async function () {
+        const store = testHelpers.createStore();
+        const directLine = WebChat.createDirectLine({ token: await testHelpers.token.fetchDirectLineToken() });
+        const styleOptions = { richCardTitleOmitHeadingRole: true };
+        const baseProps = { directLine, store, styleOptions };
+        const webChatElement = document.getElementById('webchat');
+
+        WebChat.renderWebChat(baseProps, webChatElement);
+
+        await pageConditions.uiConnected();
+
+        await pageObjects.sendMessageViaSendBox('herocard', { waitForSend: true });
+        await pageConditions.minNumActivitiesShown(2);
+        await pageConditions.allImagesLoaded();
+        await pageConditions.scrollToBottomCompleted();
+
+        const heroCardActivity = Array.from(webChatElement.querySelectorAll('.webchat__basic-transcript__activity')).find(
+          (activity) => !!activity.querySelector('.ac-textBlock')
+        );
+        expect(heroCardActivity).toBeTruthy();
+
+        const titleTextBlock = Array.from(heroCardActivity.querySelectorAll('.ac-textBlock')).find(
+          (block) => block.innerText === '\u200BDetails about image 1\u200B'
+        );
+        expect(titleTextBlock).toBeTruthy();
+
+        expect(titleTextBlock.getAttribute('role')).toBe(null);
+        expect(heroCardActivity.querySelector('.ac-textBlock[role="heading"]')).toBe(null);
+
+        await host.snapshot('local');
+      });
+    </script>
+  </body>
+</html>
@@ -25,6 +25,14 @@ type StrictAdaptiveCardsStyleOptions = {
    * Enable title (and subtitle) wrapping
    */
   richCardWrapTitle: boolean | undefined;
+
+  /**
+   * Cards: Rich Cards
+   * When `true`, omits `style: 'heading'` from the title so the rendered TextBlock has no
+   * `role="heading"` / `aria-level`. Defaults to `false` (existing behavior keeps the heading
+   * style; see issue #4327).
+   */
+  richCardTitleOmitHeadingRole: boolean | undefined;
 };
 
 type AdaptiveCardsStyleOptions = Partial<StrictAdaptiveCardsStyleOptions>;

@@ -119,11 +119,11 @@ export default class AdaptiveCardBuilder {
   }
 
   addCommonHeaders(content: ICommonContent) {
-    const { richCardWrapTitle } = this.styleOptions;
+    const { richCardTitleOmitHeadingRole, richCardWrapTitle } = this.styleOptions;
     this.addTextBlock(content.title, {
+      ...(richCardTitleOmitHeadingRole ? {} : { style: 'heading' }),
       color: TextColor.Default,
       size: TextSize.Medium,
-      style: 'heading',
       weight: TextWeight.Bolder,
       wrap: richCardWrapTitle
     });

@@ -5,6 +5,7 @@ const ADAPTIVE_CARDS_DEFAULT_STYLE_OPTIONS: Required<AdaptiveCardsStyleOptions>
   cardEmphasisBackgroundColor: '#F9F9F9',
   cardPushButtonBackgroundColor: '#0063B1',
   cardPushButtonTextColor: 'White',
+  richCardTitleOmitHeadingRole: false,
   richCardWrapTitle: false
 };