Skip to main content

Quickstart

Get from zero to a complete Webflow performance scan in under 5 minutes.

Prerequisites​

  • A Webflow account with Workspace admin access (you need to be able to authorize third-party apps for the workspace).
  • A modern browser (Chrome, Firefox, Safari, Edge — anything recent).

That's it. No CLI, no install, no server to run.

Step 1 — Connect your Webflow workspace​

  1. Go to sitehealth.octagramlabs.com

  2. Click Connect Webflow — it's free

  3. Webflow will ask you to select a workspace and authorize Site Health with read-only access:

    • authorized_user:read — your name and email
    • sites:read — list your sites
    • pages:read — list published pages
    • cms:read — inspect CMS collections for the image audit

    Site Health never writes to your Webflow account.

  4. You'll be redirected back to your dashboard with all your Webflow sites already synced.

Why OAuth read-only?

OAuth means you can revoke access anytime from Webflow's integrations settings without emailing us. Read-only means we literally cannot modify your Webflow content, even by accident.

Step 2 — Run your first scan​

On your dashboard, pick any site and click through to its detail page.

  1. Click Run Scan in the header.
  2. Choose Mobile + Desktop (recommended) and click Start.
  3. Watch the progress bar — scans typically take 3-7 minutes depending on site size.
  4. If you want to walk away, click "Email me when it's done" — we'll notify you.

While the scan runs, Site Health:

  • Fetches every published page from Webflow
  • Queues each page to Google PageSpeed Insights (both mobile and desktop)
  • Collects 30+ signals per page (scores, Core Web Vitals, opportunities, a11y audits, scripts)
  • Aggregates the results and computes a Health Score (0-100)

Step 3 — Explore the results​

Once complete, the site detail page fills with:

  • Summary cards — Health, Performance, SEO, Accessibility scores
  • Trend charts — score history across scans (appears after your 2nd scan)
  • Per-page table — sortable by Performance, with expandable rows for opportunities, accessibility issues, Best Practices, SEO, third-party scripts, and page screenshots
  • Additional metrics — Speed Index, Total Blocking Time, Time to Interactive
  • Detected frameworks — stack pack recommendations from Lighthouse

Step 4 — Turn on automation​

Scroll to the Automation section at the bottom of the site detail page:

  1. Schedule frequency → Daily or Weekly automatic scans
  2. Alert threshold → Email you when the health score drops below (e.g. 80)
  3. Weekly Digest → Toggle on for a Monday morning summary with week-over-week changes
  4. Publish Webhook → Copy the URL, paste it into Webflow's webhook settings to scan automatically on every publish

See Scheduled Scans and Alert Rules for details.

Step 5 — Share results with clients​

When a scan is complete, two buttons in the header let you share it:

  • Share Report → Creates a public URL (configurable expiry). Send this to clients — no login needed.
  • Copy as AI Prompt → Copies a ready-to-use prompt you can paste into Claude, ChatGPT, or any AI chat for analysis.

What's next​

🤖 AI-powered audits

Connect your Claude subscription via MCP for deep analysis and fix suggestions — no extra fees.

Claude.ai connector →

🔧 CI/CD integration

Fail builds when your Webflow sites miss their performance budget.

GitHub Actions setup →

⭐ Claim founding

First 100 sites get lifetime free. You're probably already claimed — verify on your dashboard.

Founding program →

Troubleshooting the first run​

The Webflow OAuth popup shows an error​

  • Make sure you're logged into Webflow in the same browser.
  • Make sure you have workspace admin permissions — you can't authorize third-party apps for a workspace you don't admin.
  • Try an incognito window if your browser has weird extensions.

"Sync failed" after connecting​

  • Check your Webflow workspace has at least one site.
  • Click Sync Sites again from the dashboard — OAuth sometimes needs a retry on the first sync.

The scan is stuck at "Queued"​

  • Free-tier PageSpeed Insights has rate limits. Your scan is waiting its turn.
  • Typical wait: under 30 seconds for small workspaces, a few minutes at peak times.

Still stuck? Email [email protected] — we monitor support.