Technical documentation

Schema API Flow — technical docs

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

Pricing: Free on the Webflow Marketplace — no subscription or in-app purchases.

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 Schema API Flow →

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.appsrow.com/auth/install (Marketplace listing URL — set in js/site-public.js when live).
Marketplace Install URL: https://api.appsrow.com/auth/install (immediate OAuth redirect).
OAuth Redirect URI: https://api.appsrow.com/auth/webflow/callback
Post-install landing: install-complete.html (next-step guidance → Designer).
Designer launch URL: https://app.appsrow.com/app.html?wfPanel=1 (embedded in Designer only).
Listing website: https://app.appsrow.com/ · Privacy: privacy.html · Terms: terms.html
Support: hello@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.
Architecture: Static JSON-LD at save time; visitor pages do not fetch api.appsrow.com.

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.appsrow.com/auth/ping → {"ok":true}.

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 Schema API Flow from the Marketplace (or open the listing when published).
OAuth starts at api.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.html with next steps.
Open Webflow Designer → Apps → Schema API Flow — 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 Schema API Flow

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.

app.appsrow.com — Demo mode

SEO meta

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

Schema API Flow — 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.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

Schema API Flow 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.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.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.appsrow.com when loading the page
Google Rich Results Test (optional) on the published URL

Help

Email hello@appsrow.com · Terms · Appsrow (Webflow site)