Why I Built a Lightweight WordPress Plugin to Manually Control JSON-LD Schema?

Jahid Shah — Mon, 18 May 2026 18:45:26 +0000

Structured data (JSON-LD) is one of the most important parts of modern SEO. It helps search engines understand content context and enables rich results like FAQs, articles, and product snippets.

However, working with WordPress at scale exposes a consistent problem:

The problem with automated schema generation

Most SEO plugins like Yoast or Rank Math automatically generate schema in the background. While this is useful for beginners, it introduces serious limitations in advanced setups:

Duplicate schema across plugins
Conflicting JSON-LD structures
Limited control over schema output
Difficulty combining multiple schema types on a single page
Lack of visibility into what is actually being injected

In complex WordPress environments, these issues often result in invalid or ignored structured data—even when everything appears “correct” in the UI.

What I needed instead

I wanted a workflow that gives full control over structured data without relying on hidden automation layers.

Specifically:

Manually define JSON-LD schema per post or page
Combine multiple schema types cleanly
Validate basic structural and duplicate issues instantly
Avoid conflicts with existing SEO plugins
Keep the system lightweight and predictable

The solution: BBH Custom Schema

To solve this, I built a lightweight WordPress plugin called BBH Custom Schema.

It is designed for developers and technical SEO workflows where control matters more than automation.

Key capabilities:

Manual JSON-LD schema injection on posts, pages, and custom post types
Schema combining system for multiple structured data blocks
Basic validation to detect formatting issues and duplicate entries
Conflict-safe implementation alongside SEO plugins like Yoast SEO and Rank Math
Lightweight architecture with no unnecessary frontend overhead

Design philosophy

This plugin is not trying to “automate SEO”.

Instead, the goal is:

Give developers full visibility and control over structured data output.

That means:

No hidden schema injection
No silent overrides
No opinionated automation logic

Just explicit, controlled, structured data management.

When this approach makes sense

This workflow is useful when:

You are managing multiple schema types per page
You need strict control over structured data output
You are debugging rich result issues
You are working in SEO-heavy or enterprise WordPress environments

What I learned building it

The biggest insight was simple:

Schema problems in WordPress are rarely about missing data—they are about conflicting data.

Most “invalid schema” issues in Google tools are actually caused by:

duplication
overlapping plugins
inconsistent injection order

Not the schema itself.

Plugin link

BBH Custom Schema
https://wordpress.org/plugins/bbh-custom-schema/

Final note

This project started as a small internal tool to solve schema conflicts in real projects. It evolved into a reusable plugin for anyone who needs precise control over structured data in WordPress.

DEV Community: Jahid Shah