microsoft · compulim · Jun 11, 2026 · Jun 6, 2026 · Jun 7, 2026 · Jun 7, 2026
@@ -19,6 +19,10 @@ Legends:
 
 ## [Unreleased]
 
+### Added
+
+- Added `styleOptions.richCardTitleAsHeading` (default `true`) to opt out of `style: 'heading'` on rich card titles, by [@cjennison](https://github.com/cjennison). Resolves the conflict with [#4327](https://github.com/microsoft/BotFramework-WebChat/issues/4327) for hosts where card titles are not navigational headings.
+
 ### Changed
 
 - Removed `markdown-it` and completed migration to `micromark`, in PR [#5825](https://github.com/microsoft/BotFramework-WebChat/pull/5825), by [@compulim](https://github.com/compulim)

@@ -0,0 +1,42 @@
+<!DOCTYPE html>
+<html lang="en-US">
+  <head>
+    <link href="/assets/index.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 = { richCardTitleAsHeading: false };
+        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.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);
+      });
+    </script>
+  </body>
+</html>
@@ -25,6 +25,13 @@ type StrictAdaptiveCardsStyleOptions = {
    * Enable title (and subtitle) wrapping
    */
   richCardWrapTitle: boolean | undefined;
+
+  /**
+   * Cards: Rich Cards
+   * When `false`, omits `style: 'heading'` from the title so the rendered TextBlock has no
+   * `role="heading"` / `aria-level`. Defaults to `true`. See issue #4327.
+   */
+  richCardTitleAsHeading: boolean | undefined;
 };
 
 type AdaptiveCardsStyleOptions = Partial<StrictAdaptiveCardsStyleOptions>;

@@ -119,11 +119,11 @@ export default class AdaptiveCardBuilder {
   }
 
   addCommonHeaders(content: ICommonContent) {
-    const { richCardWrapTitle } = this.styleOptions;
+    const { richCardTitleAsHeading, richCardWrapTitle } = this.styleOptions;
     this.addTextBlock(content.title, {
       color: TextColor.Default,
       size: TextSize.Medium,
-      style: 'heading',
+      ...(richCardTitleAsHeading === false ? {} : { 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',
+  richCardTitleAsHeading: true,
   richCardWrapTitle: false
 };