WP Schema Plugin

User guide

Documentation

Everything you need to know about installing, configuring and using WP Schema Plugin.

The basics

What is schema?

Schema markup (structured data) is a vocabulary used by search engines to understand the content of your web pages. It is maintained as an open-source project at Schema.org.

Adding structured data to HTML gives search engines more context about a page. It can help them interpret content such as products, organisations, articles and FAQs. Search result features are determined by search engines, so review your markup and follow their current guidance.

The plugin

What is WP Schema Plugin?

WP Schema Plugin is a WordPress plugin for building JSON-LD structured data through a visual interface. You can create schemas from scratch, import existing markup, use templates and review the JSON-LD before publishing it.

It is also designed to work alongside Magic Page Plugin.

User guide

Build and manage your schema.

Use these sections as a practical reference while working in WordPress.

01

Installing WP Schema Plugin

Install it like any other WordPress plugin:

  1. Download the plugin ZIP file.
  2. In WordPress, go to Plugins → Add New → Upload Plugin.
  3. Select the ZIP file, then choose Install Now.
  4. Activate the plugin.

Add your API key

After activation, select the setup message to open API Key Validation. Paste the key from your purchase email, select Verify Key, then choose Proceed once it has been validated.

02

Settings

The Settings page controls the plugin’s behaviour:

  • API Key: validates the plugin. You can hide it from other users.
  • Enabled Pages: enables schema on the home page, post types and taxonomy term pages.
  • Schema Formats: selects JSON-LD, Microdata or both for website scraping.
  • Delete Confirmation, Auto Collapse and Highlight on Hover: adjust editing safeguards and visual behaviour.
  • PHP Functions: enables advanced dynamic use. Use only if you understand the PHP involved.
  • Compatibility Mode: use if a host’s virus scanner flags the plugin’s obfuscated files.

Select Save Settings when you have finished.

03

Schema Builder

Open any supported page and select Schema Builder in the right-hand menu.

Toolbar

  • Import: bring in schema from URLs, HTML or JSON-LD.
  • Templates: open ready-made templates.
  • New Schema: start with a blank schema.
  • Help: view shortcodes and PHP snippets.
  • Save Schema: save your work before closing.
  • Close: return to the WordPress page.

Nodes

  • Add Node: add a property with a name and value.
  • Add Group Node: add a named group containing child nodes and sub-groups.
  • Minimize, Visualizer and Preview: manage complex schemas, inspect structure and review JSON-LD output.
  • Delete: removes all schema in a section.
04

Importing Schema

From a website URL

Enter one or more URLs and select Scrape. Exclude any unwanted schemas with the + control, then select Import the Schemas. Some sites block scrapers and may not return results.

From HTML or JSON-LD

Paste raw HTML and select Process HTML to find embedded schema. For JSON-LD, paste the code without <script> tags and select Process Json Schema.

Merge behaviour

  • Join (Keep Yours): merges schemas, preferring existing data.
  • Join (Prefer Imported): merges schemas, preferring imported data.
  • Fully Overwrite: replaces existing schema with the import.
05

Schema Templates

Schema Catalog

Browse community-shared schemas by type, preview them in the visualizer and import them. Review every schema before publishing it: catalog schemas are not validated.

Your Schemas

Save a schema as a personal template with a name, description and tags, then access it from any page on your site.

Sharing and transfer

You can register to share saved schemas with the community. Export saved schemas as JSON to move them between sites. Importing templates overwrites existing items in Your Schemas.

06

Shortcodes & Help

Select Help in the Schema Builder toolbar to view the available shortcodes and PHP snippets.

Shortcodes can be used inside node values to insert page-specific information such as titles, URLs and dates.

PHP functions

When enabled in Settings, PHP functions support advanced dynamic data in the builder. This requires PHP knowledge and should be used carefully.

Useful links

Continue with the right resource.