SEO Panel & Schema

Promptless WP automatically emits schema.org structured data for the content on your pages and gives you an in-editor SEO panel to audit, preview, and override what gets generated.

What This Is

When search engines crawl a page, they read both the visible content and a hidden block of structured data called schema.org markup. Schema tells Google "this section is a FAQ," "this is a service offering," "this is a how-to article" — which makes the page eligible for rich results (those expanded search listings with star ratings, FAQ accordions, recipe times, etc.).

Promptless WP now generates schema.org markup automatically based on the sections you publish. You don't have to write any markup, install another plugin, or paste JSON-LD into your pages. The plugin reads the section composition and emits the right schema types on every render.

The SEO panel in the page editor lets you see what's being emitted, run a quick audit on the page, and override the page's classification when the automatic detection picks something different from what you intended.

What Promptless Emits Automatically

When you publish a page, the plugin scans its sections and emits schema for each match it finds:

• WebPage — every Promptless page gets a baseline WebPage node with the page's heading, description, and canonical URL
• FAQPage — when the page contains a FAQ section, every question and answer becomes a structured FAQ entry that Google can show as an expandable FAQ block in search results
• HowTo — when the page contains a Steps section, the steps become a HowTo with numbered instructions
• Service — when the page is classified as a service page, every Features card becomes a Service offering with its name, description, and image
• Product with Offer — when the page contains a Pricing section, every plan with a numeric price becomes a Product with pricing details. Plans labeled "Custom," "Contact us," or anything without a real number are silently skipped (Google's pricing accuracy policy requires a numeric price)
• ImageGallery — when the page contains a Gallery section with three or more images
• Review — only when you opt in per testimonial section AND each testimonial includes a verifiable source name and URL (more on this below)
• Organization or LocalBusiness — sitewide identity, sourced from the Business Identity admin page

You can see exactly what's being emitted on any given page by opening the SEO panel in the editor (described below) and switching to the Schema tab.

The SEO Panel in the Editor

When you're editing a Promptless page, you'll see an SEO button in the editor toolbar. Clicking it opens a right-side panel with three tabs:

Audit Tab

Runs a quick SEO health check on the page and reports anything worth fixing. Three checks always run because they verify things only Promptless can check accurately:

• Image alt text — flags images that don't have descriptive text and where Promptless can't auto-derive it from a heading or name. Gallery images are the most common case (they don't have a parent heading to fall back on).
• Placeholder content — flags untouched default content from Promptless's section templates ("FlowSpace", "Productivity Redefined", "Lorem ipsum", etc.) that you forgot to replace.
• Schema validity — confirms the schema.org structured data Promptless just generated is well-formed and would pass Google's Rich Results Test.

Two additional checks run only when no SEO plugin (Yoast, Rank Math, AIOSEO, or similar) is detected on your site:

• Meta tags — flags missing post title or description sources.
• Indexability — flags pages set to noindex, posts not yet published, or the sitewide "Discourage search engines" toggle being on.

When Yoast or Rank Math is active, those last two checks are deferred — the SEO plugin you're already using surfaces those issues prominently in its own meta box, so the audit avoids duplicating the warnings. The sitewide "Discourage search engines" check is the one exception: it always runs, regardless of which SEO plugin is active, because that single setting prevents every page on your site from being indexed and is worth catching twice.

Each finding has a severity (info / warning / error) and an explanation of what to do about it. The audit re-runs every time you click the refresh button, so you can fix something, reload, and confirm the warning cleared.

Schema Tab

Shows the exact JSON-LD that the page currently emits, including which schema types are in the graph and how many nodes each one produced. The buttons let you:

• Copy JSON-LD — copies the full graph to your clipboard so you can paste it into a validator or share it with someone reviewing your SEO
• Open in Google Rich Results Test — opens Google's official validator with this page's URL pre-filled. This is the most reliable way to confirm what Google sees and which rich-result types your page qualifies for
• Refresh — re-pulls the graph after you've saved sections, so you can verify changes took effect

This tab is mainly useful for double-checking your work before a launch, or when something looks off and you want to know whether the issue is in the schema or somewhere else.

Page Type Tab

Promptless's automatic page classification is based on the section composition (a page with Features + a hero is a service page, a page with Steps and no Features is a how-to article, etc.). The classifier handles the common cases, but every site has edge cases.

The Page Type tab lets you override the automatic classification for this specific page. Options include:

• Auto-detect (default) — let the plugin decide based on sections
• Service — emits Service schema for each Features card
• About — generic about page, no special schema beyond WebPage
• Pricing — pricing-focused page
• Blog index — index of posts
• Product listing — catalog listing
• Contact — contact page
• How-to / instructional — emits HowTo from Steps even if Features is also present
• Home / landing — home page
• Generic webpage — strips back to just WebPage

When you set this, it sticks. Future deploys to the same page won't overwrite your choice unless you clear the override.

Business Identity (Required for Organization Schema)

The Business Identity admin page is where you configure the sitewide information used for Organization or LocalBusiness schema — your business name, type, address, hours, contact info, and social links.

Where to find it: WordPress admin → Promptless WP → Business Identity

What you'll set:

• Business type — pick the most specific schema.org type that fits. "Organization" is generic; LocalBusiness subtypes like Restaurant, Plumber, Dentist, BeautySalon, etc. get richer search treatment when applicable. Set this to "Not set" if you don't want any Organization or LocalBusiness schema emitted at all.
• Business name — required for any Organization or LocalBusiness emission. Without it, no business schema is generated regardless of what else is filled in.
• Phone, email — used for ContactPoint properties on Organization
• Address — only required for LocalBusiness types with a physical location. Partial addresses are accepted; fields you leave empty are simply omitted from the schema
• Hours — per-day opening hours. Days marked closed are omitted from the schema (search engines treat absence as closed). Days you leave open use the open/close times you set
• Social links — profiles on third-party platforms that represent the same business. These render as schema.org sameAs[] URLs, which Google uses to disambiguate business identity across the web. Add as many as you have — Facebook, Instagram, LinkedIn, X, YouTube, TikTok, Pinterest, GitHub, Yelp, Google Business Profile, and so on. There's no fixed cap; click "+ Add another link" for each platform

A note on data lifecycle: Business Identity is stored separately from your design settings. They live in different option keys with different update lifecycles, so saving design changes doesn't risk overwriting business data and vice versa.

A note on SEO plugins: If you have Yoast or Rank Math active and they're already emitting Organization or LocalBusiness schema, Promptless steps aside and lets them own that surface. Filling in Business Identity in Promptless is harmless — it just won't double-emit. If you're not running an SEO plugin, Promptless emits the Organization or LocalBusiness node from your Business Identity settings.

SEO Plugin Coexistence (Yoast, Rank Math, AIOSEO, others)

If you're already running an SEO plugin, Promptless detects it and adapts so you don't end up with duplicated schema.

Three modes describe how this works:

Mode A — Augment: Yoast and Rank Math expose stable filters for adding to their schema graph. When either is active, Promptless adds its section-derived schema (FAQ, HowTo, Service, Product, Gallery, Review) into their graph. The result is one merged schema block with the SEO plugin's identity nodes plus Promptless's section nodes — no duplication.

Mode B — Supplementary: For SEO plugins without a stable filter (AIOSEO, SEOPress, The SEO Framework, Slim SEO, Squirrly), Promptless emits its section-derived schema as a separate, supplementary @graph. The SEO plugin keeps its own schema; Promptless adds its sections alongside. Some duplication is possible at the WebPage level, but search engines handle this gracefully.

Mode C — Complete: When no SEO plugin is detected, Promptless emits the entire schema graph itself, including WebPage, Organization or LocalBusiness, and all the section-derived types.

You don't configure modes — Promptless picks the right one automatically based on which SEO plugin (if any) is active. If you switch SEO plugins, the mode switches too.

What this means in practice: install whichever SEO plugin you prefer, configure it normally, and Promptless will integrate with it. You don't need to disable Promptless's schema or worry about conflicts.

Reviews and the Spam Policy Gate

Google's structured data spam policy specifically prohibits sites from marking up their own self-collected testimonials as Review schema. Doing so is a manual penalty risk.

Because of that, Promptless does NOT emit Review schema by default on testimonial sections, even when you fill in author names, ratings, and quote text. The testimonials still display normally on the front-end — only the schema markup is gated.

To opt in to Review schema for a section, two conditions must be met:

1. Section-level toggle: Open the testimonial section in the editor and turn on the "These reviews come from independent sources" toggle.
2. Per-item attribution: For each testimonial, fill in the source name (e.g. "Google Business", "Trustpilot") and source URL (the URL of the review on that platform). Items missing either field are silently dropped from the schema.

Both gates exist so the schema you emit is one Google can verify. A testimonial linked to a real Google or Trustpilot review with a public URL is structured data you can defend; a self-collected quote isn't.

If you don't have independent reviews to point to, leave the toggle off and the testimonials still render visually — they just don't claim to be verifiable Reviews in the search-engine metadata.

Connector / Claude Desktop Integration

If you're using the Promptless Connector to deploy content from Claude Desktop, the connector exposes several SEO and identity tools so Claude can run audits and populate business data conversationally — not just deploy pages.

Run an SEO audit on a page

Ask Claude to audit any Promptless page and it returns the same findings the editor's Audit tab shows — image alt gaps, placeholder content, schema validity issues, and (when no SEO plugin is active) meta-tag and indexability findings. Useful as a verification step before publishing a major page revision: "Audit my home page for SEO issues" → Claude runs the audit → Claude explains the findings in plain language → you approve the fixes.

Populate Business Identity from a client brief

This is the agency-onboarding sweet spot. Once you have the client's brand brief — business name, type, contact info, address, hours, social profiles — you can ask Claude to set up the entire Business Identity record in one conversation, instead of clicking through the WordPress admin form. Example: "Set up Business Identity for Acme Plumbing — name Acme Plumbing, type Plumber, phone (555) 123-4567, address 100 Main St Springfield IL 62701, open Mon-Fri 8 to 5 and Saturdays 9 to noon, Facebook is acmeplumbing." Claude reads the brief, calls the connector, the data is saved, and the LocalBusiness schema starts emitting on every page (in Mode C — see SEO plugin coexistence above).

For incremental edits after the initial setup, Claude reads the current state, modifies only what needs to change, and writes the result back — so adding a new social link doesn't accidentally clear the existing ones.

Override the page type heuristic

Pass an explicit page_intent parameter on any page deploy to tell the plugin exactly what kind of page you're creating. This bypasses the section-composition heuristic and gives you direct control over which schema types emit. Useful for edge cases:

• An instructional how-to article that also happens to have a Features section (heuristic would call it a service page; you can explicitly say how_to)
• An "about" page that doesn't fit any obvious pattern
• A pricing page where you want only Product schema, not Service

In normal use you don't need to set this — the heuristic handles common compositions correctly and you can always override per-page in the editor's Page Type tab afterward.

Common Questions

Do I need to install a separate SEO plugin?

No. Promptless emits a complete schema graph on its own when no SEO plugin is present. Adding Yoast or Rank Math is a personal preference for the additional features they offer (XML sitemaps, focus keyword analysis, social card configuration, etc.), but it's not required for schema.

Will my pages start ranking better immediately?

Schema markup makes pages eligible for rich results — those expanded search listings — but Google decides which pages to actually show rich results for based on many factors (content quality, authority, query relevance). Schema is necessary but not sufficient. Expect rich results to start showing within days to a few weeks of Google's next crawl, and only on a portion of pages.

Can I see what schema my page is emitting before publishing?

Yes — open the SEO panel in the editor and click the Schema tab. You'll see the full JSON-LD graph as it would emit on the public page. The Open in Google Rich Results Test button is the authoritative validator.

What if Promptless's automatic page classification gets it wrong?

Open the SEO panel and use the Page Type tab to override. Your override sticks until you clear it.

What if I want to disable schema entirely?

You can disable Organization or LocalBusiness emission by setting Business Type to "Not set" in Business Identity. Section-derived schema (FAQ, HowTo, Service, etc.) is harder to disable selectively — it follows from the sections you publish. If you don't want a particular schema type, the cleanest path is to not publish the corresponding section, or to use the Page Type override to push the page into a category that doesn't trigger that schema.

Where can I see the audit checklist run from outside the editor?

The audit endpoint is also available via the Promptless Connector for Claude Desktop sessions and via the WordPress REST API for custom integrations. The same checks run in both contexts.

Next Steps

1. Open Promptless WP → Business Identity and fill in your business name and type at minimum. This unlocks Organization or LocalBusiness schema across your site.
2. Open any existing Promptless page in the editor, click the SEO button in the toolbar, and run the Audit tab to see what (if anything) needs fixing.
3. Use the Schema tab on a representative page (your home page is a good one) and click Open in Google Rich Results Test to confirm Google sees your structured data correctly.
4. Review your existing FAQ, Steps, Pricing, and Features sections — these are the section types that produce the most rich-result-eligible schema. Filling them in well pays off in search visibility.

Need Help?

For questions about the SEO panel, schema emission, or Business Identity setup: contact@promptlesswp.com