Description
AgilePress Schema JSON-LD Block is a sophisticated block for adding Schema.org structured data to your WordPress posts and pages. It provides a clean, user-friendly interface for managing JSON-LD markup without cluttering your content editor.
Key Features:
- Clean Editor Interface: Displays only a visual placeholder in the editor, keeping your workspace uncluttered
- Sidebar Editing: All JSON-LD editing happens in the Block Sidebar via InspectorControls
- Template Library: Pre-built templates for common schema types including LocalBusiness, Organization, and FAQ
- Real-time Validation: Instant JSON validation feedback as you type
- Dynamic Placeholders: Support for WordPress core placeholders and ACF custom fields
- SEO Optimized: Outputs clean JSON-LD markup via wp_head for optimal search engine parsing
Supported Placeholders:
{{title}}– Post/page title{{excerpt}}– Post excerpt{{date}}– Publication date{{url}}– Current post URL{{featured_image_url}}– Featured image URL{{acf:field_name}}– Any ACF field (supports strings and arrays)
Template Options:
- Blank – Start from scratch
- LocalBusiness – Perfect for local business listings
- Organization – For company/organization information
- FAQ – Structured FAQ markup
The block uses dynamic rendering to process placeholders on the frontend, ensuring your structured data always reflects current content.
Technical Details
The block uses a dynamic rendering approach with render_callback to process placeholders server-side. This ensures that:
- Placeholders are replaced with current data on every page load
- ACF fields are safely accessed and formatted
- Invalid JSON never reaches the frontend
- Search engines receive clean, valid JSON-LD markup
The frontend output is optimized with no extra paragraph or break tags, outputting only the pure JSON-LD script tag.
Blocks
This plugin provides 1 block.
- AgilePress Schema JSON-LD Block Manage Schema.org structured data markup with template support and dynamic placeholder replacement.
Installation
- Upload the plugin files to the
/wp-content/plugins/agilepress-schema-json-ld-blockdirectory, or install the plugin through the WordPress plugins screen directly. - Activate the plugin through the ‘Plugins’ screen in WordPress
- Add the “AgilePress Schema JSON-LD Block” block to any post or page
- Configure your JSON-LD in the Block Sidebar
- Publish and verify your structured data using Google’s Rich Results Test
FAQ
-
Does this block work with ACF (Advanced Custom Fields)?
-
Yes! The block fully supports ACF custom fields using the
{{acf:field_name}}placeholder syntax. It handles both string and array field types safely. -
How do I validate my JSON-LD?
-
The block includes real-time validation that displays “Valid JSON” or “Invalid JSON” status in the sidebar as you edit. You can also use Google’s Rich Results Test or Schema.org validator for external verification.
-
Can I use multiple schema blocks on one page?
-
Yes, you can add multiple AgilePress Schema JSON-LD Block blocks to a single page. Each will output its own separate JSON-LD script tag.
-
Where does the JSON-LD appear on my site?
-
The structured data is injected into the
<head>section of your page viawp_head, making it invisible to visitors but perfectly readable by search engines. -
What if I want to add custom schema types?
-
Start with the “Blank” template and paste in your custom JSON-LD schema. The block will validate it and process any placeholders you include.
Reviews
There are no reviews for this plugin.
Contributors & Developers
“AgilePress Schema JSON-LD Block” is open source software. The following people have contributed to this plugin.
Contributors
Translate “AgilePress Schema JSON-LD Block” into your language.
Interested in development?
Browse the code, check out the SVN repository, or subscribe to the development log by RSS.
Changelog
0.1.0
- Initial release
- Template library with LocalBusiness, Organization, and FAQ schemas
- Dynamic placeholder replacement for WordPress core and ACF fields
- Real-time JSON validation
- Clean wp_head injection without extra markup