Support Log in

Schema Markup Reference

User Guide
Prefer video? Watch the Rank Forge tutorials 9 short guides covering every feature Watch

Rank 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 Rank Forge applies it.

How Schema Works in Rank Forge

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

  • Auto-detection: Rank Forge reads your post type and content to automatically apply the most appropriate schema type on a single post or page. Blog posts get Article schema, product pages get Product schema and other pages get WebPage schema. A post or page that has at least two H2 or H3 headings ending with a question mark also gets FAQ schema (not on products).
  • 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.
  • Other pages: Settings has no Schema tab, and the automatic schema is always on. Article, Product, WebPage and FAQ markup is written on single posts and pages only. A BreadcrumbList is added on other pages whose breadcrumb trail has at least two items, and the homepage carries the Organization markup described below.

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:

text
<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:

Picked in Schema BuilderEmitted blocks (in order)Why
FAQArticle, FAQPage, BreadcrumbListQ&A-rich blog post
HowTo (with valid steps)Article, HowTo, BreadcrumbListtutorial post that doubles as a blog entry
HowTo (no/invalid steps)Article, BreadcrumbList (HowTo silently dropped)content can’t qualify as HowTo — Article still ships
RecipeArticle, Recipe, BreadcrumbListrecipe blog post
EventArticle, Event, BreadcrumbListevent announcement post
ReviewArticle, Review, BreadcrumbListproduct/place review post
(nothing — auto) + 2+ ?-headingsArticle, FAQPage, BreadcrumbListauto-FAQ pattern detected in content

If your manual selection produces the same @type Rank 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 (_rankforge_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

Schema TypeWhere It Comes FromRich Result in Google
ArticleAutomatic on single blog posts (post type post)Article appearance with headline, date, author
WebPageAutomatic on single pages and on other single post types except posts and productsBasic page listing
BreadcrumbListAutomatic on pages other than the homepage, when the breadcrumb trail has at least two itemsBreadcrumb navigation trail in results
FAQAutomatic on single posts, pages and other single post types (not products) with at least two H2 or H3 headings that end with a question mark and have text under them. Also from the Schema Builder: pick FAQ in its type menuExpandable FAQ dropdowns in results
HowToSchema Builder: pick HowTo in its type menu and type the steps into its form. The Builder also shows how many steps it finds in [rankforge_step] shortcodes or in H2 and H3 headings that do not read as questionsStep-by-step instructions in results
ProductAutomatic on products (post type product). Also from the Schema Builder: pick Product in its type menuPrice, availability, rating in results
ReviewSchema Builder: pick Review in its type menu (the Builder has no Review fields: the type is all it writes)Marks the page as a review; no rating is written
LocalBusinessLocal SEO (the Local SEO tab of Rank Forge > Tools): written on the homepage and on pages once it is switched on and has a Business NameBusiness info panel, Maps integration
OrganizationAutomatic on the homepage (not when Local SEO is switched on with a Business Name)Site name, web address and tagline as an organization
PersonNot a type of its own: the author of an Article, Review or Recipe is written as a Person inside that markupAuthor name inside the Article, Review or Recipe markup
VideoObjectPages with a videoVideo thumbnail in results, and the duration when you type it
RecipeSchema Builder: pick Recipe in its type menu and fill in its fieldsRecipe card with prep time, cook time, calories and steps
EventSchema Builder: pick Event in its type menu (the Builder has no Event fields: the type is all it writes)Marks the page as an event; no date or place is written

The type menu of the Schema Builder has no Course or SoftwareApplication choice. Its Detect with AI button asks the AI which of Article, FAQ, Product, HowTo, Recipe, Event, Review and BlogPosting fit the post, then sets the type menu to the first one the AI names and fills in the form fields of that type where it has them. The button shows only when the Pro add-on runs its AI features and its AI client is set up, and each press uses credits.

Article Schema (Auto-Detected)

When it is applied: Automatically on all blog posts (post type post). What it includes:
  • Headline (the post title, cut to 110 characters)
  • Date published and date modified
  • Author name and URL
  • Publisher (site name, home page address and, when the theme has a custom logo or the site has an icon, the logo)
  • Featured image (full size, with its width and height when WordPress knows them)
  • Word count
  • Article section (the first category in alphabetical order)
  • Keywords (the tags of the post, when it has any)
  • Description (the meta description of the post, else its first 25 words)
Manual override options:
  • Change to BlogPosting (more specific than Article)

FAQ Schema

When it is applied: Automatically on a single post or page (not on a product) that has at least two H2 or H3 headings ending with a question mark. The text under each heading, up to the next H2 or H3, is read as the answer; a heading with no text under it is skipped. Rank Forge does not read FAQ, Accordion or Details blocks. What it includes:
  • Each question as a separate FAQ item
  • The answer text for each question
How to trigger auto-detection:
  • Use H2 or H3 headings that end with a question mark, each followed by the answer text
  • Put at least two such headings on the page
Manual choice: Select “FAQ” in the type menu of the Schema Builder in the SEO box and type the questions and answers into its form (Add Q&A). With the form left empty, Rank Forge reads the question headings of the post as in the automatic case, and prints no FAQ when it finds fewer than two.

HowTo Schema

When it is applied: When you select “HowTo” in the Schema Builder dropdown for a post that contains either [rankforge_step] shortcodes or H2/H3 headings used as step titles. What it includes:
  • Name and description (the post title and the first 50 words of the post)
  • The steps, each with a name and, for a [rankforge_step] step, its text
  • The featured image of the post, as the one image of the HowTo

With the HowTo form of the Schema Builder filled in, the markup carries the name, the description and the steps you typed. Rank Forge writes no total time, tools, supplies or images for single steps.

How to add steps:
  • Use [rankforge_step title="Heat the oven"]Body text...[/rankforge_step] shortcodes (preferred — explicit step boundaries)
  • Or rely on imperative H2/H3 headings as step names (fallback when no shortcodes are present)
No steps -> no schema: If you select “HowTo” but the post contains no [rankforge_step] shortcodes and no imperative H2/H3 headings, Rank Forge will not emit a HowTo schema block at all (rather than emitting an invalid one with an empty step array, which Google Search Console flags as an error). Add at least one step heading or shortcode to get the schema back. Question-form headings are skipped: H2/H3 endings in ? (or ?) and headings that start with question-words (“how / what / why / when / where / who / which”) are excluded from HowTo step extraction — Google’s spec requires step names to be imperative actions, not questions. If your content is structured as Q&A (e.g. “How do I prep ingredients?”, “What is the temperature?”), switch the schema type to FAQ in the Schema Builder. Rank Forge will then auto-emit a FAQPage block with proper question/answer pairs.

Product Schema (WooCommerce Integration)

When it is applied: Automatically on WooCommerce product pages when WooCommerce is active. What it includes:
  • Product name
  • Description
  • Price and currency
  • Availability (in stock, out of stock)
  • SKU
  • Brand (the brand of the product, else its brand attribute, else the Default brand of the Product Markup card; no brand is written when none is set)
  • Aggregate rating (from WooCommerce reviews, written when the product has at least one review)
  • Featured image of the product
  • Item condition (written as new)
  • GTIN, when the product has a value in the GTIN, UPC, EAN, or ISBN field of WooCommerce 9.2 and later: the value needs 8, 12, 13 or 14 digits once spaces and hyphens are taken out, and is written as gtin8, gtin12, gtin13 or gtin14 by its length (a value of another length is not written)
  • MPN, from the MPN field next to the SKU of the product, else an mpn attribute
  • Price valid until (the end date of a sale, else the end of next year)
  • Shipping and return terms from the Product Markup card; each is written when every field of its block is filled in, and for products you ship yourself (not virtual or external products)
Requirements:
  • WooCommerce must be active
  • Products must have a price set
  • Rank Forge reads WooCommerce product data automatically. The default brand, the shipping terms and the return terms are set in Rank Forge > Settings, tab Search Appearance, card Product Markup

LocalBusiness Schema

When it is applied: On the homepage and on pages, once Enable Local Business Schema is ticked and a Business Name is entered on the Local SEO tab of Rank Forge > Tools (Free core). What it includes:
  • Business name
  • Address (street, city, state, postal code, country)
  • Phone number
  • Email
  • Website URL (the address of your home page)
  • Opening hours (one per line, as Mo-Fr 09:00-17:00)
  • Geo coordinates (latitude, longitude)
  • Business type (Dentist, Restaurant, etc.)
  • Price range
  • Logo (when a Logo URL is entered)
  • Social profile links (the Social Profile URLs field, one URL per line)
Business types in the Business Type menu:

The menu has 30 choices. The choice you make is written as the schema type; the table shows the schema type of each entry.

CategorySchema types
Online and genericOrganization, ProfessionalService, LocalBusiness
Food & DrinkRestaurant, BarOrPub, CafeOrCoffeeShop, Bakery
RetailStore, ClothingStore, ElectronicsStore, GroceryStore, HardwareStore
AutoAutoDealer, AutoRepair
Fitness & BeautyBeautySalon, HairSalon, HealthClub
HealthDentist, MedicalClinic, Pharmacy, VeterinaryCare
ProfessionalLegalService, AccountingService, RealEstateAgent, InsuranceAgency
TravelTravelAgency, Hotel
Home ServicesPlumber, Electrician, Locksmith

VideoObject Schema

When it is applied: On a single post or page that has a video. When you save a published post, Rank Forge looks in the content for a YouTube or Vimeo link or embed and for an HTML5 video tag with a src. You can also type the video yourself in the Video SEO section of the Rank Forge box. The markup describes one video: the Video URL you typed, or else the first video found. What it includes:
  • Video name (the title of the post)
  • Description (the Video Description you typed, else the excerpt of the post)
  • Thumbnail URL (the one you typed; for a video found in the post and no thumbnail typed, the thumbnail of that video, else the featured image; with a Video URL you typed and no thumbnail it stays empty)
  • Upload date (the publish date of the post)
  • Content URL (the address of the video)
  • Duration (only when you type it in the Video SEO section of the Rank Forge box)
  • Embed URL (for a YouTube or Vimeo video)
How to trigger auto-detection:
  • Embed a YouTube or Vimeo video using a standard WordPress embed block or URL paste, then save the published post
  • For a self-hosted video, add it to the post as an HTML5 video tag with a src, or type its address in Video URL in the Video SEO section of the Rank Forge box. That section also has Thumbnail URL, Duration (ISO 8601) and Video Description, and what you type there is used with the Video URL you type, or with the first video found when the Video URL is empty

Organization Schema

When it is applied: On the homepage, automatically. There is no Organization setting. When Local SEO is switched on and has a Business Name, the homepage carries the business type you choose in Business Type instead (LocalBusiness or a more specific type, Organization among them). What it includes:
  • Organization name (the site title)
  • URL (the address of the homepage)
  • Description (the site tagline, only when one is set)

Rank Forge writes no logo, social media profiles or contact information in Organization. The Local SEO screen has fields for those, and its markup carries them.

When to use Organization vs LocalBusiness:
  • If you are a company without a storefront that customers visit (SaaS, online business, nonprofit), leave Local SEO off: the homepage then carries the Organization markup
  • If customers come to your physical location (restaurant, dental office, retail store), switch on Local SEO and enter a Business Name: the homepage then carries the business type you choose there (LocalBusiness or a more specific type) instead
  • Rank Forge keeps one LocalBusiness profile for the whole site, with no separate locations, and writes it on the homepage and on pages. There is no setting to put it on a single 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

IssueCauseSolution
“Missing field” warningA recommended (but not required) field is emptyFill in the optional field in the SEO box or schema settings
Schema not appearing in sourceAnother plugin conflict, or the page is not a single post or pageRank Forge has no setting that turns its automatic schema off; deactivate other SEO plugins that print JSON-LD, and look at the source of a single post or page
Rich results not showing in GoogleGoogle has not recrawled, or the page does not qualifyWait 2-4 weeks; verify with Rich Results Test; ensure the content matches the schema type
Duplicate schemaTheme or another plugin also outputs schemaDisable schema output in the conflicting theme or plugin settings
Wrong schema type auto-detectedContent does not match the expected patternUse the manual schema type dropdown in the SEO box to override

—

Forge AI Assistant Online

Hi! I'm the Rank Forge AI assistant. Ask me anything about the plugin — setup, features, troubleshooting, or development.

Just now
Powered by Forge AI · Browse docs