Documentation
LiteShoper SEO Checker: Full Guide & On-Site Audit
LiteShoper SEO Checker (liteshoper-seo-checker) is a rules-based on-site auditor for your own store. Run a full check to get a score (0–100) and a prioritized list of missing meta titles, weak descriptions, thin content, empty categories, and site crawl issues.
Important: It does not crawl competitor or external websites. Live page checks stay on your store host only. Use it to diagnose; pair with SEO AI when you want generated copy.
On this page: Overview · Prerequisites · Install · Enable · Run audit · Dashboard · Issues · What it checks · Settings · SEO AI fixes · Checklist · Troubleshooting
1. Overview
- Site SEO health score (0–100)
- Audits products, posts, CMS pages, categories, homepage SEO,
sitemap.xml, androbots.txt - Severity-ranked issues: Critical, High, Medium, Low
- Fix hints + Edit links to each entity
- Duplicate title and thin content detection
- Configurable title / description / content length thresholds
- Optional same-host live HTML fetch (H1, sitemap, robots)
- Optional one-click meta fixes via SEO AI
- One-time marketplace license
Plugin page: liteshoper.com/plugins/liteshoper-seo-checker
2. Prerequisites
- LiteShoper store with published products / content
- Active
liteshoper-seo-checkerlicense - Admin user with write access to SEO Checker (to run audits)
- Optional: SEO AI installed, enabled, and API key set — only needed for auto-fix of missing/short meta
No Google Search Console or external SEO API signup is required for auditing.
3. Install the plugin
- Purchase / install from LiteShoper → SEO Checker
- Activate the plugin
- Open admin menu System → SEO Checker
4. Enable & configure settings
- Go to SEO Checker → Settings
- Check Enable SEO Checker
- Optional: Fetch live pages — fetches homepage, sitemap, robots, and sample product HTML on this host only. Turn off for a faster DB-only audit.
- Adjust thresholds if needed (defaults are sensible):
- Min / max title length (default ~30–60)
- Min / max description length (default ~70–160)
- Min content length (approx. characters of text)
- Save settings
5. Run an audit
- Open SEO Checker → Dashboard
- Click Run audit
- Wait while the job processes in chunks (progress log updates in the UI)
- When status is done, your score and issue counts appear
If a run is already running, clicking Run again resumes / watches that job. Re-run after you fix content to refresh the score.
6. Read the dashboard
- Score — 0–100 (good ≈ 80+, mid ≈ 60–79, needs work below 60)
- Severity grid — Critical / High / Medium / Low open counts
- Items with issues — how many unique site / product / post / page / category records still have problems
- Top issues — quick list; open All issues for the full filterable table
7. Work through issues
- Open SEO Checker → Issues
- Filter by severity and entity type (site, product, post, page, category)
- Fix Critical and High first (e.g. noindex on published items, missing titles, sitemap down)
- Use Edit to open the product/post/page/category editor
- Follow each issue’s fix hint
- Optional: use Fix with SEO AI for supported meta issues (see below)
- Re-run the audit to confirm the score improved
8. What the audit checks
Content entities (products, posts, pages)
| Issue (examples) | Severity | Meaning |
|---|---|---|
| Missing SEO title / description | High | Meta fields empty |
| Title / description too long or too short | Medium / Low | Outside your thresholds |
| Empty or thin content | High / Medium | Body text missing or too short |
| Missing product image | High | No image on product |
| noindex on published item | Critical | Blocked from search |
| Duplicate meta title | High | Same title on multiple URLs |
Categories & homepage
- Missing category meta title / description
- Empty homepage SEO title / description (store Settings → SEO / Homepage)
Site health (when live fetch is on)
sitemap.xmlreachable and looks like a valid XML sitemaprobots.txtreachable, hasUser-agent, and preferably aSitemap:line- Sample HTML includes an
<h1>
9. Auto-fix with SEO AI (optional)
SEO Checker detects issues; SEO AI can generate copy for some of them:
- Missing / short meta titles and descriptions
- Homepage and category missing meta fields
- Install and activate SEO AI
- Enable it and save an LLM API key under SEO AI settings
- From an issue row, click the AI fix action
- Review the generated text, then re-run the audit
If SEO AI is missing or unconfigured, the fix action returns an error pointing you to install / activate / add a key.
10. Admin pages
| Page | Path | Purpose |
|---|---|---|
| Dashboard | seo-checker |
Score, severity summary, run audit |
| Issues | seo-checker/issues |
Filterable issue list + fixes |
| Settings | seo-checker/settings |
Enable, live fetch, thresholds |
11. Go-live checklist
- Plugin installed and enabled
- First audit completed (status done)
- Critical / High issues cleared or accepted
/sitemap.xmland/robots.txtOK (if live fetch enabled)- Homepage SEO title + description set
- Re-run audit; score improved
- Optional: SEO AI ready for ongoing meta fixes
12. Troubleshooting
| Issue | Fix |
|---|---|
| Run audit disabled / error “disabled” | Enable SEO Checker in Settings |
| Audit stuck on “running” | Click Run audit again to resume; or refresh after a few minutes |
| Score stays low after edits | Re-run audit — results are from the last completed run |
| Sitemap / robots critical issues | Confirm URLs open publicly on the store domain; fix core SEO routes |
| “seo_ai_required” | Install/activate SEO AI and add API key |
| Want DB-only speed | Turn off “Fetch live pages” in Settings |
| Expected competitor URL analysis | Not supported — this plugin is same-host / this store only |
References:
LiteShoper SEO Checker · SEO AI (optional fixes) · In-store: System → SEO Checker