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.
Top comments (0)