Quality Audits
Quality Audits scans your Shopify store for SEO issues, content quality problems, and accessibility concerns. Ensure your store is optimized for search engines and provides a great experience for all
Quality Audits
Quality Audits scans your Shopify store for SEO issues, content quality problems, and accessibility concerns. Ensure your store is optimized for search engines and provides a great experience for all customers.
Overview
Quality issues can hurt your search rankings, conversion rates, and customer trust. Quality Audits detects:
- SEO Problems: Missing or poorly optimized meta information
- Content Issues: Spelling errors, placeholder text, thin content
- Accessibility Gaps: Missing ARIA labels, poor contrast
- Structural Problems: Broken links, missing images
Getting Started
Running an Audit
- Navigate to Quality in the sidebar
- Click Run Audit
- Wait for the scan to complete (typically 2-5 minutes)
- Review the results by category and severity
Audit Scope
Quality Audits scans:
- All Pages: Homepage, collection pages, product pages, blog posts
- All Products: Titles, descriptions, images, variants
- Theme Files: Liquid templates, content sections
- Blog Content: Posts, author pages, tag pages
Issue Categories
SEO Hygiene
Problems that affect search engine optimization:
| Issue | Impact | Detection |
|---|---|---|
| Missing Meta Title | Page won't rank well | No <title> tag |
| Missing Meta Description | Poor search snippets | No meta description |
| Meta Title Too Long | Truncated in results | > 60 characters |
| Meta Description Too Long | Truncated in results | > 160 characters |
| Missing Alt Text | Images not indexed | <img> without alt |
| Duplicate Titles | Confusion for crawlers | Same title on multiple pages |
| Missing H1 | Unclear page topic | No <h1> on page |
| Multiple H1s | Confusing structure | More than one <h1> |
Content Quality
Problems with your store's written content:
| Issue | Impact | Detection |
|---|---|---|
| Spelling Errors | Unprofessional appearance | Dictionary comparison |
| Lorem Ipsum | Incomplete content visible | Pattern matching |
| Placeholder Text | Unprofessional appearance | Pattern matching |
| Thin Content | Poor SEO, low value | < 100 words on key pages |
| Duplicate Content | SEO penalties | Similarity analysis |
| Missing Content | Empty sections | Blank areas detected |
Accessibility
Issues affecting users with disabilities:
| Issue | Impact | Detection |
|---|---|---|
| Missing ARIA Labels | Screen readers can't interpret | Interactive elements without labels |
| Low Color Contrast | Text hard to read | Contrast ratio < 4.5:1 |
| Missing Form Labels | Forms hard to use | Inputs without associated labels |
| Missing Skip Links | Navigation difficulty | No skip to content link |
| Non-descriptive Links | Unclear navigation | "Click here" link text |
Understanding Results
Quality Score
Each audit produces an overall score (0-100):
┌─────────────────────────────────────────────────────────────┐
│ QUALITY AUDIT RESULTS │
│ │
│ Overall Score: 78 / 100 │
│ │
│ ┌───────────────────────────────────────────┐ │
│ │ SEO: ████████████░░░ 82% │ │
│ │ Content: ██████████░░░░░ 68% │ │
│ │ Accessibility: ████████████████ 92% │ │
│ └───────────────────────────────────────────┘ │
│ │
│ Issues Found: 28 │
│ ├─ Critical: 2 │
│ ├─ High: 8 │
│ ├─ Medium: 12 │
│ └─ Low: 6 │
└─────────────────────────────────────────────────────────────┘
Issue Severity
| Severity | Criteria | Examples |
|---|---|---|
| Critical | Major SEO or accessibility blocker | Missing meta title on homepage |
| High | Significant impact | Lorem ipsum on product page |
| Medium | Should be fixed | Meta description too long |
| Low | Minor improvement | Missing alt text on decorative image |
Issue Details
Viewing an Issue
Click any issue to see full details:
┌─────────────────────────────────────────────────────────────────┐
│ ISSUE: Missing Meta Description │
│ │
│ Severity: HIGH Category: SEO │
│ Location: /collections/summer-sale │
│ Page Type: Collection │
│ │
│ ───────────────────────────────────────────────────────────── │
│ │
│ DESCRIPTION │
│ This collection page is missing a meta description. Search │
│ engines will auto-generate a snippet, which may not │
│ accurately represent your content. │
│ │
│ CURRENT STATE │
│ Title: "Summer Sale | Your Store" │
│ Description: (none) │
│ │
│ RECOMMENDATION │
│ Add a meta description between 120-160 characters that │
│ describes the collection and includes relevant keywords. │
│ │
│ Example: │
│ "Shop our Summer Sale collection with up to 50% off │
│ selected items. Find deals on clothing, accessories, and │
│ more. Limited time only." │
│ │
│ [Edit in Shopify] [Create Ticket] [Ignore] │
└─────────────────────────────────────────────────────────────────┘
Taking Action
For each issue:
- Edit in Shopify: Go directly to the item in Shopify admin
- Create Ticket: Add to your task management system
- Bulk Fix: For some issues, apply fixes to multiple items
- Ignore: Mark as intentional or false positive
Filtering and Sorting
Filter Options
| Filter | Options |
|---|---|
| Severity | Critical, High, Medium, Low |
| Category | SEO, Content, Accessibility |
| Page Type | Products, Collections, Pages, Blogs |
| Status | Open, Ignored, Fixed |
Sorting
- Severity (default): Most critical first
- Category: Grouped by issue type
- Page: Grouped by location
- Recent: Newest issues first
Bulk Operations
Bulk Fix
Some issues support bulk fixing:
- Select multiple issues (checkbox)
- Click Bulk Actions
- Choose operation:
- Generate Meta Descriptions: AI-powered generation
- Add Missing Alt Text: Based on product/image data
- Fix Spelling: Auto-correct detected errors
- Review changes before applying
- Click Apply Fixes
Bulk Ignore
For intentional patterns or false positives:
- Select issues
- Click Bulk Actions > Ignore
- Provide reason (optional)
- Confirm
SEO Dictionary
Access the SEO reference guide:
- Click Dictionary in the Quality section
- Browse SEO terms and best practices
- Understand why each issue matters
- Learn recommended solutions
Example Entries
Meta Title
- What: The
<title>tag defining the page title - Why: Displays in search results and browser tabs
- Best Practice: 50-60 characters, include primary keyword
Meta Description
- What: HTML meta tag describing page content
- Why: Appears as snippet in search results
- Best Practice: 120-160 characters, compelling call to action
Scheduling Audits
Automatic Audits
Configure automatic audits in Settings:
- Daily: Best for active stores with frequent changes
- Weekly: Good balance for most stores
- Monthly: Minimal for stable stores
Manual Triggers
Run audits after:
- Adding new products or collections
- Updating theme or content
- Before major sales or campaigns
Trend Tracking
Historical Data
View quality trends over time:
Quality Score Trend (90 days)
100 ┤
90 ┤ ╭────────╮
80 ┤ ╭────╯ ╰───────────────────────
70 ┤───╯
60 ┤
└────────────────────────────────────────
Nov Dec Jan
Regression Alerts
Get alerted when quality drops:
- Score drops > 10 points
- New critical issues appear
- Previously fixed issues return
Best Practices
SEO Optimization
- Every page needs a unique meta title and description
- Use target keywords naturally in titles and descriptions
- Keep titles under 60 characters to avoid truncation
- Write compelling meta descriptions that encourage clicks
- Add alt text to all meaningful images
Content Quality
- Review before publishing - catch spelling errors
- Remove all placeholder content before going live
- Aim for 300+ words on key pages
- Use unique content - don't duplicate from other sites
Accessibility
- Add labels to all form inputs
- Ensure sufficient color contrast
- Provide text alternatives for images
- Use semantic HTML (proper headings, lists, etc.)
Integration with Other Features
Theme Intelligence
Quality issues related to theme code are linked to Theme Intelligence findings for coordinated fixes.
Tickets
Create tickets directly from quality issues to track through resolution.
Action Center
Bulk quality fixes can be executed through the Action Center with preview and approval.
Troubleshooting
Audit Won't Complete
- Large stores may take longer
- Check for connection issues
- Try running a targeted audit on specific pages
False Positives
- Use Ignore for intentional patterns
- Report persistent false positives to support
Missing Pages
- Ensure pages are published
- Check that pages aren't password protected
- Verify Shopify API access
Related Features
- Theme Intelligence - Code-level analysis
- Lighthouse - Performance metrics
- Action Center - Bulk operations