Technical documentation

SchemaPilot - technical docs

Architecture notes, Marketplace reviewer checklist, and detailed implementation docs. For step-by-step end-user instructions, see the User Guide.

Pricing: Free tier (limited pages) + optional Pro plans on Dashboard → Plans. No ads in the app. See Terms - Fees.

Last updated: August 6, 2026

Try without OAuth

Open the app and click Try demo to explore the UI with sample pages. Connect Webflow to save to a real site.

Open demo →

Install

Install from the Marketplace, approve OAuth, then open the app from Webflow Designer → Apps.

Install SchemaPilot →

Data & privacy

In-app disclosure before OpenAI Generate. Full policy and CMS embed guide below.

Privacy - OpenAI →

Webflow Marketplace reviewers

Submission fields (must match live behavior):
Install URL: https://api-schemapilot.appsrow.com/auth/install (Marketplace listing URL - set in js/site-public.js when live).
Marketplace Install URL: https://api-schemapilot.appsrow.com/auth/install (immediate OAuth redirect).
OAuth Redirect URI: https://api-schemapilot.appsrow.com/auth/webflow/callback
Post-install landing: install-complete (next-step guidance → Designer).
Designer launch URL: https://schemapilot.appsrow.com/app?wfPanel=1 (embedded in Designer only).
Listing website: https://schemapilot.appsrow.com/ · Privacy: privacy · Terms: terms
Support: sales@appsrow.com · Full listing copy: repo MARKETPLACE-LISTING.md
Categories: SEO, AI, Content Management, Marketing, Development and Coding.
After install, Designer panel launch → Connected to Webflow (single OAuth).
Static pages: JSON-LD via registered inline scripts (Custom Code API) - no raw head HTML or manual copy-paste.

App type: Hybrid App (Data Client + Designer Extension).
Pricing: Free tier + optional Pro licenses (dashboard pricing page).
Architecture: Static JSON-LD at save time; visitor pages do not fetch api-schemapilot.appsrow.com. Hybrid auth: OAuth install once → Designer getIdToken() → POST /auth/designer-id-token → Webflow /beta/token/resolve.

Option A - Demo mode (no login)

Install from Marketplace, then open the app in Webflow Designer → Apps.
Select sample pages, click Generate (AI consent modal appears on first generate).
Note: Save is disabled in demo - use Option B to test save + publish.

Option B - Full test (recommended)

In the submission form, provide App Access Credentials: a dedicated Webflow account (email + password) with a published site that has static pages and at least one CMS collection.

Install from listing → approve OAuth.
Connect in app → load pages → generate SEO + JSON-LD → save → publish in Webflow.
View-source on live URL → confirm application/ld+json; Network tab shows no API calls on page load.
API health: api-schemapilot.appsrow.com/auth/ping → {"ok":true}.

Hybrid auth (ID tokens)

Per Webflow’s guide on authenticating Designer Extensions with a Data Client (User Authentication with ID Tokens):

User completes OAuth (Marketplace Install URL or Connect Account) - access token stored on our API.
Designer Extension calls webflow.getIdToken() and posts to POST /auth/designer-id-token (optional site id/name).
Backend verifies with Webflow POST https://api.webflow.com/beta/token/resolve using stored OAuth token + ID token.
Backend mints an app Bearer for the iframe Data Client UI. Scope authorized_user:read is required.

We never collect Webflow passwords. Credential fields on customer sites are out of scope (Marketplace credential field rules).

Marketplace listing copy

Use these values in the Webflow submission form. Short description (max 100 characters):

Generate JSON-LD and SEO meta for Webflow pages. Save structured data via the official Data API.

Feature list (max 5): One-click OAuth · AI-assisted JSON-LD · Static & CMS pages · Save to Webflow · SEO health indicators.

Long description, categories, and screenshot specs: see MARKETPLACE-LISTING.md in the repository root.

Install & connect

Install SchemaPilot from the Marketplace (or open the listing when published).
OAuth starts at api-schemapilot.appsrow.com/auth/install - approve scopes: sites:read pages:read pages:write custom_code:read custom_code:write cms:read cms:write authorized_user:read.
After approval, you land on install-complete with next steps.
Open Webflow Designer → Apps → SchemaPilot - you should see Connected to Webflow. If not, click Connect Webflow.
SEO health dots (🔴 / 🟡 / 🟢) load from browser cache immediately; background checks run after connect or Refresh Pages.
To switch workspace: Disconnect (instant) → Connect Webflow again. Custom code cleanup continues in the background.

Webflow - Authorize SchemaPilot

Approve scopes: sites, pages, custom code, CMS → redirects to app with Connected to Webflow.

Static pages

Select a static page from the list → Reload Page if needed.
Optional: Generate Title / Generate Description (OpenAI - in-app notice shown).
Choose schema types → Generate per type → review JSON-LD.
Save Selected Page - attaches a registered inline script via Custom Code API (Page settings → Custom code → Apps).
Publish in Webflow → view-source on live URL → confirm application/ld+json from the app script.

schemapilot.appsrow.com - Demo mode

SEO meta

Data sent on Generate: title, description, URL → OpenAI

SchemaPilot - JSON-LD & SEO…

Generate valid schema.org structured data…

Generate Title Generate Description

JSON-LD

{"@context":"https://schema.org","@graph":[…]}

Save Selected Page

CMS collections

Select a CMS template page → Load CMS Config → Create Meta Fields if prompted.
One-time: copy embed code from the app into the Collection template Embed in Webflow Designer.
Pick a CMS item → Load Item Meta → generate schema → Save CMS Item.
Publish → verify live CMS URL view-source.

CMS template embed (one time)

Open the Collection page template in Webflow Designer.
Add an Embed before </body>.
Paste the app’s embed snippet using {{wf:Schema JSON-LD Plain|Dynamo}} (or your field name).
Publish the site. JSON-LD is static in HTML - no call to api-schemapilot.appsrow.com on page load.

CMS item - sample loaded

Getting started with structured data

A demo blog post showing Article schema…

{"@type":"BlogPosting","headline":"Getting started…"}

Collection template Embed outputs {{wf:Schema JSON-LD Plain|Dynamo}} - no API call on page load.

JSON-LD bounds & delivery

SchemaPilot injects static JSON-LD when you click Save - never on visitor page load.

2,000-character inline script limit: Webflow caps each registered inline sourceCode at 2,000 characters. Larger @graph payloads are split into multiple inline scripts (one schema.org node per script when needed).
Static pages: JSON-LD is delivered only via registered inline scripts attached with the Custom Code API (Page settings → Custom code → Apps). No raw head HTML fallback.
Legacy cleanup: Disconnect signs you out immediately; removal of older head markers and registered scripts continues in the background while OAuth is valid.
CMS: Item JSON-LD lives in the Schema JSON-LD Plain field and is output via your Collection template Embed - static HTML, no api-schemapilot.appsrow.com fetch.

Full details: Support - JSON-LD size limits.

Uninstall & custom code removal

Before uninstall: Open the app and click Disconnect - immediate sign-out; registered scripts and legacy head blocks are removed in the background across authorized sites while OAuth is still valid.
Marketplace uninstall: Revoke the app in Webflow workspace settings. Webflow removes app-registered scripts on the next Publish; use Disconnect first for CMS fields.
Webhook: POST https://api-schemapilot.appsrow.com/webhooks/uninstall with Bearer app token (same cleanup as Disconnect).

Step-by-step: Support - Uninstall & custom code.

AI generation & privacy

AI runs only when you click Generate. The app shows a persistent notice in the SEO and schema panels plus a one-time confirmation modal per browser session. Page title, description, URL, and schema context may be sent to OpenAI. FAQ Q&A is taken from published page content when possible - not invented by AI.

Details: Privacy Policy.

Verify on live site

View page source → <script type="application/ld+json">
DevTools → Network → no requests to api-schemapilot.appsrow.com when loading the page
Google Rich Results Test (optional) on the published URL

Help

Email sales@appsrow.com · Terms · SchemaPilot (Webflow site)