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:
<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 Builder | Emitted blocks (in order) | Why |
|---|---|---|
| FAQ | Article, FAQPage, BreadcrumbList | Q&A-rich blog post |
| HowTo (with valid steps) | Article, HowTo, BreadcrumbList | tutorial 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 |
| Recipe | Article, Recipe, BreadcrumbList | recipe blog post |
| Event | Article, Event, BreadcrumbList | event announcement post |
| Review | Article, Review, BreadcrumbList | product/place review post |
(nothing — auto) + 2+ ?-headings | Article, FAQPage, BreadcrumbList | auto-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 Type | Where It Comes From | Rich Result in Google |
|---|---|---|
| Article | Automatic on single blog posts (post type post) | Article appearance with headline, date, author |
| WebPage | Automatic on single pages and on other single post types except posts and products | Basic page listing |
| BreadcrumbList | Automatic on pages other than the homepage, when the breadcrumb trail has at least two items | Breadcrumb navigation trail in results |
| FAQ | Automatic 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 menu | Expandable FAQ dropdowns in results |
| HowTo | Schema 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 questions | Step-by-step instructions in results |
| Product | Automatic on products (post type product). Also from the Schema Builder: pick Product in its type menu | Price, availability, rating in results |
| Review | Schema 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 |
| LocalBusiness | Local 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 Name | Business info panel, Maps integration |
| Organization | Automatic on the homepage (not when Local SEO is switched on with a Business Name) | Site name, web address and tagline as an organization |
| Person | Not a type of its own: the author of an Article, Review or Recipe is written as a Person inside that markup | Author name inside the Article, Review or Recipe markup |
| VideoObject | Pages with a video | Video thumbnail in results, and the duration when you type it |
| Recipe | Schema Builder: pick Recipe in its type menu and fill in its fields | Recipe card with prep time, cook time, calories and steps |
| Event | Schema 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 typepost).
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)
- 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
- 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
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)
[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
mpnattribute - 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)
- 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
- 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)
The menu has 30 choices. The choice you make is written as the schema type; the table shows the schema type of each entry.
| Category | Schema types |
|---|---|
| Online and generic | Organization, ProfessionalService, LocalBusiness |
| Food & Drink | Restaurant, BarOrPub, CafeOrCoffeeShop, Bakery |
| Retail | Store, ClothingStore, ElectronicsStore, GroceryStore, HardwareStore |
| Auto | AutoDealer, AutoRepair |
| Fitness & Beauty | BeautySalon, HairSalon, HealthClub |
| Health | Dentist, MedicalClinic, Pharmacy, VeterinaryCare |
| Professional | LegalService, AccountingService, RealEstateAgent, InsuranceAgency |
| Travel | TravelAgency, Hotel |
| Home Services | Plumber, 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 HTML5video 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)
- 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
videotag with asrc, 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:
- 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. - View Page Source — Right-click on your page, select View Page Source, and search for
application/ld+jsonto see the raw JSON-LD output. - 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
| Issue | Cause | Solution |
|---|---|---|
| “Missing field” warning | A recommended (but not required) field is empty | Fill in the optional field in the SEO box or schema settings |
| Schema not appearing in source | Another plugin conflict, or the page is not a single post or page | Rank 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 Google | Google has not recrawled, or the page does not qualify | Wait 2-4 weeks; verify with Rich Results Test; ensure the content matches the schema type |
| Duplicate schema | Theme or another plugin also outputs schema | Disable schema output in the conflicting theme or plugin settings |
| Wrong schema type auto-detected | Content does not match the expected pattern | Use the manual schema type dropdown in the SEO box to override |
—