For users & QA testers
OnPageIQ Documentation
Step-by-step guides with where to click, what you should see, and what QA must verify — including negative cases and tier gates.
Architecture at a glance
Organization-scoped multi-tenant SaaS. All project data belongs to one organization.
Organization (billing, credits, tier, team)
└── Project
├── Url → Scan → ScanResult → Issue
├── SeoAudit (+ 50+ background jobs)
├── SiteArchitecture (crawl tree)
├── RedirectMonitor
├── Integrations (GSC, GA4)
└── Addons (screenshots, LLM listening, DNS, …)QA smoke checklist
Run before every release. Full detail in the QA Handbook.
Auth & tenancy
- Log in with email/password and OAuth (Google/Microsoft) if configured
- Verify dashboard loads; credit balance matches org tier
- Org B user cannot open Org A project URL (403/404)
Core scan flow
- Create project → add URL → run quick scan → issues appear
- Scan consumes credits; insufficient credits blocks scan with clear message
- Export PDF/CSV on entitled tiers
Project navigation
- Every sidebar icon loads without 500/403 (or shows upgrade when gated)
- Business group shows Business Profile + Local listings (upgrade when addon off)
- Project settings tabs save and persist
Background jobs
- SEO audit, architecture crawl, security audit complete in Horizon
- Company Intelligence / Local Listings scrapes drain on company-enrichment and directory-listings queues
- Failed jobs surface in UI or logs; no infinite spinner
Addons
- Inactive addon → upgrade page (not blank 403)
- Active addon → feature routes load; mutations respect policy
- Local Listings: confirm a provider URL / candidate; Incomplete soft-fails refund unlocks; unlink + report bad; Filament Directory Profiles shows the row
Test accounts
Local / staging only. Never use on production.
| Account | Login | Tier | Purpose |
|---|---|---|---|
| Platform Docs Demo | platform-docs@onpageiq.test / password | enterprise | General feature capture & smoke testing (most flags enabled) |
| Screenshot Addon Demo | qa-screenshot@onpageiq.test / password | free (screenshot_addon enabled) | Screenshot gallery, live highlights, viewport states |
Tier matrix
| Feature | Free | Pro | Team | Enterprise |
|---|---|---|---|---|
| Spelling checks | ✓ | ✓ | ✓ | ✓ |
| Grammar / SEO / readability | — | ✓ | ✓ | ✓ |
| SEO audit suite | — | ✓ | ✓ | ✓ |
| API access | — | ✓ | ✓ | ✓ |
| PDF export | — | ✓ | ✓ | ✓ |
| Team & assignments | — | — | ✓ | ✓ |
| Google Search Console | — | — | ✓ | ✓ |
| Redirect / URL monitor | — | — | ✓ | ✓ |
| Intelligence hub | — | — | ✓ | ✓ |
| DNS monitoring addon | — | ✓ | ✓ | ✓ |
| Keyword research addon | — | ✓ | ✓ | ✓ |
| Company Intelligence addon | — | ✓ | ✓ | ✓ |
| Local Listings addon | — | ✓ | ✓ | ✓ |
| LLM listening addon | — | — | — | ✓ |
| SSO | — | — | — | ✓ |
QA & Testing
Test accounts, smoke checklists, tier matrix, and regression rules.
QA Handbook Updated · Aug 15, 2026
How to test OnPageIQ: smoke checklist, regression rules, job queues, and what to file as bugs.
Open guide →
Reading a System Error Updated · Aug 21, 2026
What a system_error audit row tells you, and how to see the real error on a testing environment instead of "Server Error".
Open guide →
Tenant Isolation Testing
Mandatory cross-org tests: Org A data must never leak to Org B.
Open guide →
Test Environment & Accounts
Seeders, demo credentials, and commands to reset local QA data.
Open guide →
Tiers & Feature Gates
What each subscription tier unlocks and how Pennant flags / addons interact.
Open guide →
Getting Started
Orientation, navigation, and first-run flows for new users.
Core Features
Content quality, SEO, architecture, monitoring, and integrations.
AI Business Profile & Keyword Assist Updated · Aug 29, 2026
Let AI infer your market, audience, competitors, and priority keywords from your crawl — then reuse it in Keyword Research and AI Visibility (LLM Listening).
Open guide →
AI Traffic Attribution New · Aug 2, 2026 Needs testing
Measure the traffic AI assistants (ChatGPT, Perplexity, Gemini, Copilot, and more) actually send you — confirmed AI referrals from your GA4 data, a separate "Possible AI Direct" estimate for referrer-stripped visits, a regex simulator for GA4 channel groups, and a client-ready PDF.
Open guide →
Analytics
One page with a tab per connected analytics or search provider — Google Search Console, GA4, Bing Webmaster — rendered through a shared metrics panel.
Open guide →
Canonicals
Audit dual-source canonical tags, triage issues in a slide-over, validate against GSC URL Inspection, map relationships, and export CSV — nested under Search & Visibility.
Open guide →
Competitors
One curated competitor list per project — grounded in real ranking data, corrected by you, and reused by Keyword Opportunities, AI Visibility and reports.
Open guide →
Content Scans Updated · Aug 27, 2026
Run spelling, grammar, SEO, and readability checks against project URLs.
Open guide →
Developer Insights
The engineering read on an audit: Core Web Vitals, JavaScript and third-party scripts, caching and compression, API health, and security-header coverage.
Open guide →
Dictionaries
Org-wide and project-specific spelling dictionaries and conflict resolution.
Open guide →
Duplicate Content
Find pages that say the same thing, see exactly what overlaps, and record how you fixed it.
Open guide →
Exports & Reports
PDF/CSV/JSON/XLSX exports for scans, issues, metadata, and org reports.
Open guide →
H1 Above the Fold
Check whether each page’s primary H1 is visible without scrolling — with annotated desktop/mobile screenshots you can trust-but-verify in SEO Audit.
Open guide →
Integrations (GSC & GA4)
Connect Google Search Console and Google Analytics 4 per project.
Open guide →
Intelligence Hub
Cross-source insights combining GSC, GA4, scans, and audits.
Open guide →
Issues Workflow
Triage, assign, and resolve spelling/SEO/security issues via kanban and filters.
Open guide →
Location Intelligence Reports
Turn any discovered area into a sourced, per-area report — demographics, income, housing, growth, and hazard data with provenance — plus a grounded AI narrative and one-click localized SEO targets.
Open guide →
Market Intelligence
Discover nearby areas with Census demographics, Fit & Opportunity scoring, and a numbered map that matches the table — then send included areas to Keyword Research and AI Visibility.
Open guide →
Performance Insights
Core Web Vitals and performance metrics from crawled pages.
Open guide →
Project Health Updated · Aug 27, 2026
One composite health score for the project, its four domain sub-scores, what changed since last time, and what to fix next.
Open guide →
Project Settings
Every per-project configuration surface in one tabbed page — crawl behaviour, schedules, integrations, environments, notifications, dictionary, writing style, local SEO, and deletion.
Open guide →
Projects & URLs Updated · Aug 15, 2026
Manage projects, URL inventory, tags, and page-level detail.
Open guide →
Runtime Diagnostics
Browser console errors, network failures, and CSP violations from audited pages.
Open guide →
SEO Audit Updated · Aug 16, 2026
Site-wide SEO audit dashboard with crawl status, scores, and deep-dive sub-routes.
Open guide →
SEO Page Surfaces
Metadata, OpenGraph, Schema, Sitemap, Canonicals, Anchor text, robots.txt, and AI crawlers (llm.txt).
Open guide →
Scheduled Scans
Recurring scan schedules with credit reservation and refund on skip.
Open guide →
Security Dashboard Updated · Aug 16, 2026
One page for the security of a site: a graded score, a prioritised "what to fix" list, and continuous Google Safe Browsing monitoring.
Open guide →
Site Architecture
Visual crawl tree, click-depth analysis, orphan detection, and architecture export — plus the definitions behind every number on the Statistics panel.
Open guide →
URL Management (URLs, scanning & monitoring)
Manage project URLs; toggle redirect/uptime monitoring, status codes, and alert channels per URL.
Open guide →
Platform
Billing, team, API, exports, dictionaries, and org settings.
API Tokens & Webhooks
Create Sanctum API tokens and configure outbound webhook endpoints for integrations.
Open guide →
Billing & Subscriptions
Manage subscription tier, purchase credits, add-ons, and view billing history.
Open guide →
Notifications
In-app notification inbox for scans, assignments, billing, and monitor alerts.
Open guide →
Organization Settings
Org profile, org-wide dictionary, diagnostics patterns, and defaults.
Open guide →
Team & Departments
Invite members, assign roles, and organize departments on Team tier and above.
Open guide →
Addons
Optional org-scoped modules gated by tier, Pennant, or Stripe.
AI Visibility (LLM Listening) Updated · Aug 19, 2026
See how the answer engines describe your brand — overall, per engine, and per place you serve — with the evidence behind every number.
Open guide →
Company Intelligence
Look up firmographic detail for a list of company domains and keep it in a shared, org-level library.
Open guide →
Content Strategy New · Aug 20, 2026
Find what competitors publish, which buyer questions nobody owns, and what to change when an AI answer cites someone else.
Open guide →
DNS Monitoring Add-on Updated · Aug 31, 2026 Needs testing
Watch MX, SPF, DKIM, DMARC, NS and DNSSEC for every domain — with a health score that shows its working, and alerts when a record changes.
Open guide →
Editorial Review New · Aug 30, 2026 Needs testing
Check live pages against your own editorial, brand and legal rules.
Open guide →
File Parity
Compare the same artifact (PDF/HTML/JSON/CSV) across your dev, staging, UAT, and production environments, and surface drift with evidence.
Open guide →
Headings Outliner Add-on
H1–H6 outline per URL with hierarchy issues and CSV/JSON/Markdown export.
Open guide →
Keyword Research Add-on
Discover keyword opportunities from GSC data and AI analysis on project SEO surfaces.
Open guide →
Listing Alignment New · Aug 4, 2026 Needs testing
Confirm a location’s business identity on Project Settings → Local SEO, then audit name/address/phone/website alignment across website, schema, Google, directories, and Apple/Azure — with honest Not tested when a source is unavailable, plus findings and tasks when sources disagree.
Open guide →
Local AEO Visibility (retired — see AI Visibility) Updated · Aug 19, 2026
Retired. Everything it measured now lives inside AI Visibility, behind a per-project local mode.
Open guide →
Local Listings New · Jul 29, 2026 Needs testing
Match BBB, Yelp, Angi, Trustpilot, and G2 listings to a project (Google Business Profile sync planned), confirm the right business, and surface reputation proofs in Business Profile, Local SEO, and Intelligence.
Open guide →
Local Rankings (GeoGrid)
Track Google local-pack rankings across a geographic grid, with a square or radial (concentric-ring) layout, a rank heatmap, and PDF reports.
Open guide →
Preflight
Launch-readiness board: what still blocks putting this site into production, reported as two numbers that are never averaged.
Open guide →
Reputation Monitor New · Jul 29, 2026 Needs testing
Check what public blocklists and threat sources report about your domains and IPs — email/sending reputation, website threats, and infrastructure trust.
Open guide →
Screenshot Add-on
Capture desktop/tablet/mobile screenshots per URL, gallery view, live compare, and highlight annotations.
Open guide →
Security Monitoring
Turns the one-shot security audit into continuous monitoring — score history, regression alerts, and scheduled re-audits.
Open guide →
Threat Detection Add-on Updated · Aug 30, 2026
Pattern-based compromise detection during crawls with AI verdict second opinion.
Open guide →
Refresh screenshots
php artisan db:seed --class=PlatformDocsDemoSeeder
php artisan test tests/Browser/Docs
php artisan docs:publishImages source: docs/platform/images/ → public: platform-doc-images/