=== BBH Custom Schema – Add Custom JSON-LD to Your Website ===
Contributors: jahidshah
Donate link: https://www.buymeacoffee.com/jahidshah
Tags: schema, schema markup, structured data, json-ld, rich results
Requires at least: 5.2
Tested up to: 6.9
Requires PHP: 7.2
Stable tag: 1.3.3
License: GPLv2 or later
License URI: https://www.gnu.org/licenses/gpl-2.0.html  

Add and manage custom JSON-LD schema in WordPress without SEO plugin limitations, duplicate schema conflicts, or unnecessary overhead.

== Description ==

**BBH Custom Schema** helps you add, manage, and control custom JSON-LD schema in WordPress — without the limitations, conflicts, or unnecessary bloat often caused by traditional SEO plugins.

Many SEO plugins automatically generate structured data, but they can restrict customization, create duplicate schema, or output markup you cannot fully control. This makes advanced schema management difficult for developers, agencies, and SEO professionals.

BBH Custom Schema gives you direct control over your structured data by allowing you to manually add and manage JSON-LD schema on individual posts and pages. You decide exactly what schema is output, how it is structured, and where it appears.

The plugin also helps manage multiple schema blocks, validate JSON formatting, and combine separate JSON-LD structures into a clean valid format — all directly inside the WordPress editor.

Built for developers, SEO professionals, freelancers, and advanced WordPress users who need flexible and precise schema implementation without unnecessary complexity.

Note: This plugin does not generate schema automatically. You must provide valid JSON-LD markup.

🎥 Fix schema issues and take full control of JSON-LD
👉 Watch full tutorial: https://youtu.be/vtijgX5JWr0

== Key Features ==

* Full control over WordPress schema output without SEO plugin limitations
* Fix duplicate and conflicting schema generated by SEO plugins like Rank Math or Yoast
* Add custom JSON-LD schema to any post or page with complete flexibility
* Manage multiple schema types including Article, Product, FAQPage, LocalBusiness, Service, and more
* Combine multiple JSON-LD blocks into a single valid structure to avoid errors
* Works alongside existing SEO plugins without breaking or overriding them
* Lightweight and performance-friendly — outputs only the schema you define
* Built for developers, SEO professionals, and advanced WordPress users
* Clean, distraction-free editor integration inside WordPress

Note: Validation only checks JSON format validity.

Plugin homepage:
https://jahidshah.com/plugins/bbh-custom-schema/

== Other Plugins By Jahid Shah ==
<ul>
    <li><a href="https://wordpress.org/plugins/bbh-custom-schema/" >BBH Custom Schema</a></li>
    <li><a href="https://wordpress.org/plugins/aj-faq-block/" >AJ FAQ Block</a></li>
    <li><a href="https://wordpress.org/plugins/aj-card-element/" >AJ Card Element</a></li>
    <li><a href="https://wordpress.org/plugins/aj-square-testimonial-slider/" >AJ Square Testimonial Slider</a></li>
    <li><a href="https://wordpress.org/plugins/aj-category-posts/" >AJ Category Posts</a></li>
    <li><a href="https://wordpress.org/plugins/ajx-filter-for-woo/" >AJx Filter for WooCommerce</a></li>
</ul>

== Installation ==
**Minimum Requirements**
- WordPress 5.2 or higher  
- PHP 7.2 or higher  
- MySQL 5.0 or higher

**Automatic Installation (Recommended)**
1. Go to your WordPress dashboard  
2. Navigate to **Plugins > Add New**  
3. Search for **BBH Custom Schema**  
4. Click **Install Now** and activate the plugin  

**Manual Installation**
1. Download the plugin ZIP file  
2. Unzip and upload the `bbh-custom-schema` folder to `/wp-content/plugins/`  
3. Go to **Plugins > Installed Plugins** and click **Activate**  

== Usage ==

1. Create or edit any post or page.  
2. Scroll down and look for the **"BBH Custom Schema (Click to Expand)"** section below the content editor.  
3. Click the arrow to expand the field.
4. Paste your JSON-LD schema markup inside the box.
4. Click “Validate Schema” to check JSON format validity.
5. If using multiple JSON-LD blocks, paste them one after another (without &lt;script&gt; tags), then click “Combine Schemas” to merge them into a single valid structure.
5. Click **Publish** or **Update** to save your changes.  
6. Your schema will be added to the page source as JSON-LD structured data inside the website header (not visible to visitors).

== Frequently Asked Questions ==

= What is schema markup? =

Schema markup is a special type of structured data that helps search engines understand the content of your website more clearly. Instead of only reading plain text, search engines like Google can identify specific information such as articles, products, reviews, FAQs, events, and more.

When schema markup is added correctly, search engines may display enhanced search results called rich results. These can include extra details like star ratings, FAQ dropdowns, product prices, or article information. Rich results can make your page more noticeable in search results and may increase the chance that users click on your website.

This plugin allows you to add custom JSON-LD schema markup to any post or page so search engines can better interpret your content.

= Why I use This Plugin? =
This plugin lets you:
* Add custom schema manually
* Fix duplicate schema conflicts
* Helps manage custom schema alongside existing structured data
* Improve search engine understanding
You stay in control of your SEO structure.

= Do I need coding knowledge to use this plugin? =

Basic knowledge of schema markup can be helpful, but it is not required. The plugin simply provides a place where you can add your schema in JSON-LD format, which is the format recommended by Google.

If you already have schema generated from tools such as Google’s Structured Data Markup Helper or other schema generators, you can copy the JSON-LD code and paste it into the schema box provided by the plugin.

Advanced users and developers may prefer this approach because it gives full control over the schema structure without being limited by preset schema templates.

= Does this plugin slow down my website? =

No. The plugin is designed to be lightweight and does not add unnecessary scripts, styles, or database queries to your website.

It simply inserts the JSON-LD schema markup into the page output when the page loads. Since JSON-LD is just structured data placed inside a <script type="application/ld+json"> tag, it has no visual impact and minimal performance overhead.

Because of this simple approach, the plugin should not affect your page speed or website performance.

= Is it compatible with Rank Math, Yoast SEO, or other SEO plugins? =

Yes. The plugin is designed to work alongside popular SEO plugins such as Rank Math, Yoast SEO, and other SEO tools.

In many cases, SEO plugins automatically generate schema markup based on your content. However, sometimes users need to add custom schema that those plugins do not support.

This plugin allows you to insert your own JSON-LD schema and, when necessary, manages custom schema alongside existing structured data. This gives developers and SEO professionals more flexibility when implementing structured data strategies.

= Can I add schema to any post or page? =

Yes. The plugin allows you to add custom JSON-LD schema to individual posts or pages directly from the WordPress editor. This makes it easy to apply structured data only where it is needed instead of affecting the entire website.

= How can I check if my schema is working? =

After adding schema to your page, you can verify it using tools such as Google Rich Results Test or other structured data testing tools. These tools will show whether your schema markup is detected and if there are any errors or warnings.

Testing your schema helps ensure that search engines can properly read and interpret the structured data you added.

= How do I view the custom schema markup? =
Schema markup is for search engines and not displayed to visitors. To see it:
- Press `Ctrl + U` (View Page Source) on your post or page  
- Press `Ctrl + F` and search for "schema" or "ld+json" to find the script

= How can I generate custom schema markup? =  
This plugin allows you to generate and manage custom schema markup without external tools. You can define structured data in JSON-LD format, assign it to specific content, and control how search engines interpret your pages. Take your require format from below example and modify as your needs.

Also you can use free online tools like: 
- https://technicalseo.com/tools/schema-markup-generator/
- or, AI (like ChatGPT, Gemini).

= How do I validate my schema markup? =  
Use these tools to test your schema:
- Inside Post editor you will see a Validate Schema button, simple just click on the button, and check the validity.
- or use [Google Rich Results Test](https://search.google.com/test/rich-results)  
- or, [Schema.org Validator](https://validator.schema.org/)  

= Is BBH Custom Schema responsive? =  
Yes, the plugin is fully responsive and works on desktop, tablet, and mobile devices.

= Does this plugin automatically generate schema? =
No. It only outputs the JSON-LD schema you manually provide. This ensures full control without hidden modifications or SEO plugin interference.

= Can you provide schema markup examples? =
Yes. Example schemas are available inside official schema.org documentation.

= How to Use These Schema? =
1. Copy any schema example above  
2. Paste it into the plugin schema editor  
3. Customize it for your content  
4. Assign it to posts or pages  
5. Publish and let search engines read it  

= Can I use Multiple Schemas? =
Yes. You can paste multiple JSON-LD schemas one after another (without &lt;script&gt; tags).

Click the **Combine Schemas** button to merge them into a single valid JSON-LD structure. This resolves syntax errors caused by multiple separate JSON objects.

The tool combines your schemas without modifying the original data.

After that, click **Schema Validity Check** to verify. You should see: "Valid JSON".

== Screenshots ==

1. Example of schema applied to a post  
2. Custom Schema input box under post/page editor  
3. Plugin settings in the admin panel  

== Changelog ==

= 1.0.0 =  
* Initial release

= 1.0.1 =  
* Update CSS and fix errors

= 1.1.0 =
* Introduced Content Schema Report feature – a dashboard section that lists posts and pages with or without custom schema markup. 
* Helps administrators quickly identify which content needs schema implementation.
* Added pagination support for easier navigation through large content libraries.

= 1.2.0 =
* Added settings page to select post types for meta box
* Supports Custom Post Types (CPT)

= 1.2.1 =
* New: Added a review request notice for the WordPress.org plugin page.
* Improvement: Review notice now appears after the plugin has been used multiple times.
* Improvement: Added options to dismiss or postpone the review request.
* Fix: Resolved missing CSS styling issues.

= 1.2.2 =
* New: Added JSON-LD validation feature in the post editor.
* New: "Validity Check" button for instant client-side validation using JSON.parse.
* New: AJAX fallback handler for server-side validation.
* Improvement: Green/red inline feedback for valid/invalid JSON.

= 1.2.3 =
* New: Schema Combiner feature - to use Multiple Schema

= 1.3.0 =
* New: Quick Start onboarding page
* New: First-time users see minimal UI with 3 schema buttons
* New: FAQ Schema (Recommended), Article Schema, Custom JSON-LD options
* New: Schema draft saves temporarily and applies on post save

= 1.3.1 =
* New: Basic Validation engine (JSON + Duplicate Check) - validates JSON syntax, structure (@context, @type, required fields), labeled as "Basic Validation (JSON + Duplicate Check)" not Google validation
* Add guide video

= 1.3.2 =
* New: Update schema control system.

= 1.3.3 =
* Improved UI styling for better readability and user experience.
* Added step-by-step BBH Custom Schema setup guide inside the documentation page.

== Upgrade Notice ==
The latest Version is compatible with previous version, So nothing to worry

== Other Notes ==

== Customize Your Schema:==

You can use any schema type supported by [schema.org](https://schema.org). Simply paste the JSON-LD script into the provided field on each post or page.

== Support & Contact ==

**Need help or want to report an issue?**

For any issues, please open a support ticket in the WordPress plugin repository or visit our [support page](https://www.jahidshah.com/contact-me/).