Schema Markup Reference

SEO Forge supports a wide range of schema types to help your content appear as rich results in Google. This reference describes each supported type, when to use it, and how SEO Forge applies it.

How Schema Works in SEO Forge

Schema markup is output as JSON-LD in the section of every page. SEO Forge uses a combination of auto-detection and manual configuration:

• Auto-detection: SEO Forge reads your post type, content structure, and settings to automatically apply the most appropriate schema type. Blog posts get Article schema. Pages with FAQ blocks get FAQ schema. Product pages get Product schema.
• Manual selection (additive): In the SEO box on any post or page, you can pick a schema type (FAQ, HowTo, Recipe, Event, Review, Product, VideoObject) from the Schema Builder. As of April 2026 this adds to the auto-detected output rather than replacing it — see “Multiple schemas on one post” below.
• Global defaults: The schema types applied to archives, homepage, and other non-singular pages are configured in SEO Forge > Settings > Schema.

Multiple schemas on one post

Picking a schema type in the Schema Builder layers on top of the auto-detected default. A blog post with HowTo picked emits:

<script type="application/ld+json"> { "@type": "Article",  ... } </script>
<script type="application/ld+json"> { "@type": "HowTo",    ... } </script>
<script type="application/ld+json"> { "@type": "BreadcrumbList", ... } </script>

This is intentional — Google can use multiple rich-result types from a single page, and stripping the Article block would cost the post its standard blog-rich-result eligibility. Common stacks:

If your manual selection produces the same @type SEO Forge would emit anyway (e.g. picking FAQ on a post that already has 2+ question-marked H2 headings), only one block is emitted — the manual one wins so any custom fields you set are preserved.

The full manual JSON-LD path (_seoforge_manual_schema post meta) is the one exception: when you paste complete custom JSON-LD it owns the entire emit and only BreadcrumbList layers on top. Use that when you need exact control over the shape.

Supported Schema Types

Article Schema (Auto-Detected)

• Headline (from SEO title or post title)
• Date published and date modified
• Author name and URL
• Publisher (site name and logo)
• Featured image
• Word count
• Article section (from category)

• Change to NewsArticle (for news sites)
• Change to BlogPosting (more specific than Article)
• Change to ScholarlyArticle (for academic content)

FAQ Schema

• Each question as a separate FAQ item
• The answer text for each question

• Use H3 headings formatted as questions followed by paragraph answers
• Use the WordPress FAQ block
• Use ACF FAQ repeater fields (if Field Forge is also active)

HowTo Schema

• Step-by-step instructions
• Total time (if specified)
• Tools and supplies needed (if specified)
• Images for individual steps (if present)

• Use [seoforge_step title="Heat the oven"]Body text...[/seoforge_step] shortcodes (preferred — explicit step boundaries)
• Or rely on imperative H2/H3 headings as step names (fallback when no shortcodes are present)

Product Schema (WooCommerce Integration)

• Product name
• Description
• Price and currency
• Availability (in stock, out of stock)
• SKU
• Brand (if set)
• Aggregate rating (from WooCommerce reviews)
• Product images

• WooCommerce must be active
• Products must have a price set
• SEO Forge reads WooCommerce product data automatically — no manual configuration needed

LocalBusiness Schema

• Business name
• Address (street, city, state, postal code, country)
• Phone number
• Email
• Website URL
• Opening hours
• Geo coordinates (latitude, longitude)
• Business type (Dentist, Restaurant, etc.)
• Price range
• Accepted payment methods

VideoObject Schema

• Video name (from the post title or video title)
• Description
• Thumbnail URL
• Upload date
• Duration (when available from the embed)
• Embed URL

• Embed a YouTube or Vimeo video using a standard WordPress embed block or URL paste
• For self-hosted videos, select “VideoObject” from the schema type dropdown and fill in the required fields

Organization Schema

• Organization name
• Logo
• URL
• Social media profiles (Facebook, Twitter/X, LinkedIn, Instagram, YouTube)
• Contact information

• Use Organization if you are a company without a storefront that customers visit (SaaS, online business, nonprofit)
• Use LocalBusiness if customers come to your physical location (restaurant, dental office, retail store)
• You can have both — Organization on the homepage and LocalBusiness on a dedicated locations page

Testing Your Schema Markup

After configuring schema on any page, verify it is working correctly:

1. Google Rich Results Test (search.google.com/test/rich-results) — The primary testing tool. Enter your URL and see exactly what Google can read, including any errors or warnings.
2. View Page Source — Right-click on your page, select View Page Source, and search for application/ld+json to see the raw JSON-LD output.
3. Schema.org Validator (validator.schema.org) — A more detailed validator that checks against the full schema.org specification, not just Google’s subset.

Common Schema Issues

—