feat: add validators for LocalBusiness, Article, Event, FAQPage, HowT… #58

gsriram24 · 2026-01-07T11:37:42Z

Summary

Add validators for commonly-used schema.org types that Google Rich Results supports:

LocalBusiness: requires name, address; recommends geo, image, telephone, url, etc.
Article (+ BlogPosting, NewsArticle via inheritance): requires headline; recommends author, datePublished, image, etc.
Event: requires name, startDate, location (or online eventAttendanceMode)
FAQPage: requires mainEntity (with nested Question/Answer validators)
QAPage: requires mainEntity, mainEntity.answerCount (Google's Q&A Page requirement)
Question: requires name, acceptedAnswer OR suggestedAnswer; recommends text
Answer: requires text
HowTo: requires name, step; recommends tools, supply, totalTime, etc.
WebSite: requires name, url; recommends potentialAction

Automatic Subtype Inheritance

This PR also introduces automatic validator inheritance for schema.org subtypes. When validating a type that doesn't have its own registered validator, the library automatically falls back to parent type validators by traversing the rdfs:subClassOf hierarchy.

Examples:

Subtype	Inherits Validation From
`Restaurant`, `Store`, `Hotel`, `Dentist`	`LocalBusiness`
`NewsArticle`, `BlogPosting`, `TechArticle`	`Article`
`MusicEvent`, `SportsEvent`, `Festival`	`Event`

This enables validation of 100+ schema types without needing individual validator files for each.

How it works:

Direct handler mappings are checked first (priority)
If no direct mapping exists, parent types are looked up from schemaOrgJson
First parent with a registered handler is used

Changes

Added 8 new validator files (LocalBusiness.js, Article.js, Event.js, FAQPage.js, HowTo.js, WebSite.js, Question.js, Answer.js)
Added #getParentTypes() and #getHandlersForType() methods to validator.js for inheritance
Added test fixtures in gallery/ and src/types/__tests__/
Minor fix to Product.test.js to filter for errors only

Testing

All existing tests pass (228 passing)
New tests added for each validator
Verified inheritance works for 50+ schema subtypes

Closes #56

…o, and WebSite Add validators for commonly-used schema.org types that Google Rich Results supports: - LocalBusiness: requires name, address; recommends geo, image, telephone, etc. - Article (+ BlogPosting, NewsArticle): requires headline; recommends author, dates, etc. - Event: requires name, startDate, location/eventAttendanceMode - FAQPage: requires mainEntity (with Question/Answer validators) - HowTo: requires name, step; recommends tools, supplies, etc. - WebSite: requires name, url; recommends potentialAction Also includes: - Question and Answer validators for FAQPage support - Test fixtures in gallery/ and src/types/__tests__/ - Minor fix to Product.test.js to filter for errors only Closes adobe#56

…/structured-data-validator into feature/new-validators

gsriram24 · 2026-01-08T15:21:46Z

Hi, would any of the maintainers let me know if this would be considered or if there's anything I missed?

noruiz · 2026-01-29T02:21:28Z

src/types/LocalBusiness.js

+
+      this.recommended('aggregateRating', 'object'),
+      this.recommended('geo', 'object'),
+      this.recommended('image', 'url'),


image can also be an object https://developers.google.com/search/docs/appearance/structured-data/local-business#carousel

noruiz · 2026-01-29T02:30:55Z

src/validator.js

+      : [typeEntry['rdfs:subClassOf']];
+
+    return parents.map((p) => {
+      const id = p['@id'] || p;


is it ever possible for p to be null?

noruiz · 2026-01-29T02:43:17Z

src/types/Event.js

+    ].map((c) => c.bind(this));
+  }
+
+  locationOrAttendanceMode(data) {


Should probably also check for location.name https://developers.google.com/search/docs/appearance/structured-data/event#structured-data-type-definitions

herzog31

Thanks for your contribution.

I raised a few inconsistencies compared to the Google Rich Results documentation available at https://developers.google.com/search/docs/appearance/structured-data.

herzog31 · 2026-01-29T10:28:09Z

src/validator.js

+
+    return parents.map((p) => {
+      const id = p['@id'] || p;
+      return id


Please re-use https://github.com/adobe/structured-data-validator/blob/main/src/types/schemaOrg.js#L23 here.

herzog31 · 2026-01-29T10:37:56Z

src/types/WebSite.js

+ */
+import BaseValidator from './base.js';
+
+export default class WebSiteValidator extends BaseValidator {


This library bases the implementation for attribute constraints on documentation provided by Google at https://developers.google.com/search/docs/appearance/structured-data/search-gallery as the schema.org specification does not mandate required fields.

As the WebSite type is not part of the Google Rich Results gallery, I recommend to not add this handler. A handler like this can be added to the validator as part of your project.

herzog31 · 2026-01-29T10:45:14Z

src/types/HowTo.js

+ */
+import BaseValidator from './base.js';
+
+export default class HowToValidator extends BaseValidator {


My comment about the WebSite type applies here as well.

While HowTo is not supported, HowToStep is and already available in the project.

herzog31 · 2026-01-29T10:46:51Z

src/types/FAQPage.js

+
+export default class FAQPageValidator extends BaseValidator {
+  getConditions() {
+    return [this.required('mainEntity', 'arrayOrObject')].map((c) => c.bind(this));


Please additionally check that mainEntity contains at least one item.

https://developers.google.com/search/docs/appearance/structured-data/faqpage#faq-page

herzog31 · 2026-01-29T10:53:29Z

src/types/Event.js

+      this.recommended('eventAttendanceMode'),
+      this.recommended('eventStatus'),
+      this.recommended('image', 'arrayOrObject'),
+      this.recommended('offers', 'arrayOrObject'),


Please adjust the Offer type to selectively add recommended attributes availability, price, priceCurrency, validFrom and url for when used within an Event type. The Offer type already contains this logic for use with Product as a reference.

herzog31 · 2026-01-29T10:53:29Z

src/types/Event.js

+      this.recommended('endDate', 'date'),
+      this.recommended('eventAttendanceMode'),
+      this.recommended('eventStatus'),
+      this.recommended('image', 'arrayOrObject'),


Could also be an URL as string.

herzog31 · 2026-01-29T10:54:37Z

src/types/Article.js

+export default class ArticleValidator extends BaseValidator {
+  getConditions() {
+    return [
+      this.required('headline'),


According to the documentation, headline is only a recommended property.

https://developers.google.com/search/docs/appearance/structured-data/article

herzog31 · 2026-01-29T10:54:49Z

src/types/Article.js

+      this.recommended('author', 'arrayOrObject'),
+      this.recommended('dateModified', 'date'),
+      this.recommended('datePublished', 'date'),
+      this.recommended('image', 'arrayOrObject'),


Can be an URL as string as well.

herzog31 · 2026-01-29T10:56:55Z

src/types/Article.js

+      this.recommended('dateModified', 'date'),
+      this.recommended('datePublished', 'date'),
+      this.recommended('image', 'arrayOrObject'),
+      this.recommended('publisher', 'object'),


This attribute is optional according to the documentation. Basically recommending that the publisher of an article should not be listed as part of the author attribute, but using publisher.

https://developers.google.com/search/docs/appearance/structured-data/article

gsriram24 added 3 commits January 7, 2026 17:00

Merge branch 'feature/new-validators' of https://github.com/gsriram24…

a82c7af

…/structured-data-validator into feature/new-validators

herzog31 added the enhancement New feature or request label Jan 28, 2026

herzog31 requested review from herzog31 and noruiz January 28, 2026 10:11

noruiz reviewed Jan 29, 2026

View reviewed changes

herzog31 reviewed Jan 29, 2026

View reviewed changes

feat: add validators for LocalBusiness, Article, Event, FAQPage, HowT… #58

Are you sure you want to change the base?

feat: add validators for LocalBusiness, Article, Event, FAQPage, HowT… #58

Uh oh!

Conversation

gsriram24 commented Jan 7, 2026 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Summary

Automatic Subtype Inheritance

Examples:

How it works:

Changes

Testing

Uh oh!

gsriram24 commented Jan 8, 2026

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

herzog31 left a comment

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Reviewers

Assignees

Labels

Projects

Milestone

Development

Uh oh!

3 participants

gsriram24 commented Jan 7, 2026 •

edited

Loading