Shopify Theme Check: Linting & CI for Themes

Theme Check scans Liquid for deprecated tags, missing templates, performance issues, and accessibility problems. Run in CI via GitHub Actions on every pull request.

This guide targets search queries around theme check, shopify lint, theme ci. ADSPOC publishes these articles so merchants, freelancers, and developers in India can find authoritative answers without wading through outdated forum threads.

Rules are configurable in .theme-check.yml. Fix errors before Theme Store submission.

Shopify's ecosystem moves fast: Online Store 2.0, Checkout Extensibility, Markets, and B2B features change what "best practice" means each year. Treat this topic as part of your store's architecture—not a one-time checkbox.

ADSPOC curriculum requires Theme Check pass before client theme delivery.

Indian shoppers expect mobile-first UX, UPI and COD options, WhatsApp support, and GST-compliant invoicing. Any Shopify implementation that ignores these signals loses conversions even if the underlying code is technically correct.

Ignoring RemoteAsset and ImgWidthAndHeight warnings.

Theme Check, PageSpeed Insights, and Shopify's admin analytics exist to catch these issues before they cost revenue. Schedule quarterly reviews—especially before Diwali, Republic Day sales, and Black Friday/Cyber Monday if you sell globally.

1. Install theme-check gem or CLI 2. Run locally 3. Fix errors by priority 4. Add CI workflow 5. Block merge on errors 6. Review monthly rule updates

Document decisions in your theme README or Notion so future developers (or your future self) understand why settings were configured a certain way. ADSPOC delivers this documentation with every client handoff.