@quintype/seo 1.51.0 → 1.52.2

package/CHANGELOG.md

@@ -2,6 +2,12 @@
 
 All notable changes to this project will be documented in this file. See [standard-version](https://github.com/conventional-changelog/standard-version) for commit guidelines.
 
+### [1.52.2](https://github.com/quintype/quintype-node-seo/compare/v1.52.1...v1.52.2) (2026-06-24)
+
+### [1.52.1](https://github.com/quintype/quintype-node-seo/compare/v1.52.0...v1.52.1) (2026-06-24)
+
+## [1.52.0](https://github.com/quintype/quintype-node-seo/compare/v1.51.0...v1.52.0) (2026-06-24)
+
 ## [1.51.0](https://github.com/quintype/quintype-node-seo/compare/v1.50.3...v1.51.0) (2026-06-03)
 
 

package/dist/index.cjs.js

@@ -809,6 +809,46 @@ function getCompleteTextOfOneCard(storyElements, stripHtmlFromArticleBody) {
   return getTextElementsOfOneCard(storyElements).map(item => stripHtmlFromArticleBody ? getPlainText(item.text) : item.text).join(".");
 }
 
+function getFaqQuestionItem(question = "", answer = "") {
+  const name = getPlainText(question).trim();
+  const text = getPlainText(answer).trim();
+
+  if (!name || !text) return null;
+
+  return {
+    "@type": "Question",
+    name,
+    acceptedAnswer: {
+      "@type": "Answer",
+      text
+    }
+  };
+}
+
+function getFaqMainEntity(story = {}) {
+  const cards = get__default["default"](story, ["cards"], []);
+  const faqItems = [];
+
+  cards.forEach(card => {
+    const storyElements = get__default["default"](card, ["story-elements"], []);
+
+    storyElements.forEach(element => {
+      if (element.type !== "text") return;
+      if (element.subtype !== "q-and-a") return;
+
+      const metadataQuestion = get__default["default"](element, ["metadata", "question"], "");
+      const metadataAnswer = get__default["default"](element, ["metadata", "answer"], "");
+
+      if (metadataQuestion && metadataAnswer) {
+        const metadataFaqItem = getFaqQuestionItem(metadataQuestion, metadataAnswer);
+        if (metadataFaqItem) faqItems.push(metadataFaqItem);
+      }
+    });
+  });
+
+  return faqItems;
+}
+
 function generateLiveBlogPostingData(structuredData = {}, story = {}, publisherConfig = {}, timezone) {
   const imageWidth = 1200;
   const imageHeight = 675;
@@ -1486,6 +1526,20 @@ function StructuredDataTags({ structuredData = {} }, config, pageType, response
     return products.length ? products : null;
   }
 
+  function generateFaqTags() {
+    const mainEntity = getFaqMainEntity(story);
+    if (!mainEntity.length) return null;
+
+    return ldJson("FAQPage", { mainEntity });
+  }
+
+  if (!isStructuredDataEmpty && (pageType === "story-page" || pageType === "story-page-amp")) {
+    const faqTags = generateFaqTags();
+    if (faqTags) {
+      tags.push(faqTags);
+    }
+  }
+
   // All Pages have: Publisher, Site
   // Story Page have : Article/NewsArticle/LiveBlog/Review as appropriate
   return tags;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@quintype/seo",
-  "version": "1.51.0",
+  "version": "1.52.2",
   "description": "SEO Modules for Quintype",
   "main": "dist/index.cjs.js",
   "repository": "https://github.com/quintype/quintype-node-seo",

package/src/structured-data/structured-data-tags.js

@@ -290,6 +290,46 @@ function getCompleteTextOfOneCard(storyElements, stripHtmlFromArticleBody) {
     .join(".");
 }
 
+function getFaqQuestionItem(question = "", answer = "") {
+  const name = getPlainText(question).trim();
+  const text = getPlainText(answer).trim();
+
+  if (!name || !text) return null;
+
+  return {
+    "@type": "Question",
+    name,
+    acceptedAnswer: {
+      "@type": "Answer",
+      text,
+    },
+  };
+}
+
+function getFaqMainEntity(story = {}) {
+  const cards = get(story, ["cards"], []);
+  const faqItems = [];
+
+  cards.forEach((card) => {
+    const storyElements = get(card, ["story-elements"], []);
+
+    storyElements.forEach((element) => {
+      if (element.type !== "text") return;
+      if (element.subtype !== "q-and-a") return;
+
+      const metadataQuestion = get(element, ["metadata", "question"], "");
+      const metadataAnswer = get(element, ["metadata", "answer"], "");
+
+      if (metadataQuestion && metadataAnswer) {
+        const metadataFaqItem = getFaqQuestionItem(metadataQuestion, metadataAnswer);
+        if (metadataFaqItem) faqItems.push(metadataFaqItem);
+      }
+    });
+  });
+
+  return faqItems;
+}
+
 function generateLiveBlogPostingData(structuredData = {}, story = {}, publisherConfig = {}, timezone) {
   const imageWidth = 1200;
   const imageHeight = 675;
@@ -1050,6 +1090,20 @@ export function StructuredDataTags({ structuredData = {} }, config, pageType, re
     return products.length ? products : null;
   }
 
+  function generateFaqTags() {
+    const mainEntity = getFaqMainEntity(story);
+    if (!mainEntity.length) return null;
+
+    return ldJson("FAQPage", { mainEntity });
+  }
+
+  if (!isStructuredDataEmpty && (pageType === "story-page" || pageType === "story-page-amp")) {
+    const faqTags = generateFaqTags();
+    if (faqTags) {
+      tags.push(faqTags);
+    }
+  }
+
   // All Pages have: Publisher, Site
   // Story Page have : Article/NewsArticle/LiveBlog/Review as appropriate
   return tags;

package/test/structured_data_tags_test.js

@@ -662,6 +662,88 @@ describe("StructuredDataTags", function () {
     });
   });
 
+  describe("with FAQ schema data", function () {
+    it("adds FAQPage schema for q-and-a subtype when both question and answer are in metadata", function () {
+      const cards = [
+        {
+          "story-elements": [
+            {
+              type: "text",
+              subtype: "q-and-a",
+              metadata: {
+                question: "What is FAQ Schema?",
+                answer: "FAQ Schema is structured data that helps search engines understand FAQ content.",
+              },
+            },
+            {
+              type: "text",
+              subtype: "q-and-a",
+              metadata: {
+                question: "Is FAQ markup mandatory?",
+                answer: "No, it is optional.",
+              },
+            },
+          ],
+        },
+      ];
+
+      const string = getSeoMetadata(
+        getSeoConfig({ newsArticle: false }),
+        {},
+        "story-page",
+        sampleStoryData(null, cards, sampleAuthorsData()),
+        { url: url.parse("/") }
+      );
+      const ampPageString = getSeoMetadata(
+        getSeoConfig({ newsArticle: false }),
+        {},
+        "story-page-amp",
+        sampleStoryData(null, cards, sampleAuthorsData()),
+        { url: url.parse("/") }
+      );
+
+      assertContains('"@type":"FAQPage"', string);
+      assertContains('"name":"What is FAQ Schema?"', string);
+      assertContains('"acceptedAnswer":{"@type":"Answer","text":"FAQ Schema is structured data that helps search engines understand FAQ content."}', string);
+      assertContains('"name":"Is FAQ markup mandatory?"', string);
+      assertContains('"text":"No, it is optional."', string);
+      assertContains('"@type":"FAQPage"', ampPageString);
+    });
+
+    it("does not add FAQPage schema when q-and-a metadata is missing question or answer", function () {
+      const cards = [
+        {
+          "story-elements": [
+            {
+              type: "text",
+              subtype: "q-and-a",
+              metadata: {
+                question: "What is FAQ Schema?",
+              },
+            },
+            {
+              type: "text",
+              subtype: "q-and-a",
+              metadata: {
+                answer: "Only answer, no question.",
+              },
+            },
+          ],
+        },
+      ];
+
+      const string = getSeoMetadata(
+        getSeoConfig({ newsArticle: false }),
+        {},
+        "story-page",
+        sampleStoryData(null, cards, sampleAuthorsData()),
+        { url: url.parse("/") }
+      );
+
+      assertDoesNotContains('"@type":"FAQPage"', string);
+    });
+  });
+
   describe("articleBody content", function () {
     const cards = [
       {