Shopify Liquid Themes

This is a comprehensive reference for anyone building or maintaining Shopify themes. It covers the full Liquid syntax with all the gotchas that trip people up (no parentheses in conditions, 50-iteration loop limits, contains only works on strings). The schema documentation is especially useful, with a decision table for picking the right setting type and concrete examples of section versus block structure. It also includes quick lookups for filters, tags, and objects so you're not constantly switching to Shopify docs. If you're working on theme customization or app blocks, this gives you the patterns and constraints in one place instead of scattered across official documentation.

skills.sh installs: 3.9K
GitHub stars: 120
last updated: Aug 21, 2026

View on GitHub

Install

$ npx -y skills add benjaminsehl/liquid-skills --skill shopify-liquid-themes --agent claude-code

Installs into .claude/skills of the current project.

Files

Shopify Liquid Themes

Theme Architecture

.
├── sections/    # Full-width page modules with {% schema %} — hero, product grid, testimonials
├── blocks/      # Nestable components with {% schema %} — slides, feature items, text blocks
├── snippets/    # Reusable fragments via {% render %} — buttons, icons, image helpers
├── layout/      # Page wrappers (must include {{ content_for_header }} and {{ content_for_layout }})
├── templates/   # JSON files defining which sections appear on each page type
├── config/      # Global theme settings (settings_schema.json, settings_data.json)
├── locales/     # Translation files (en.default.json, fr.json, etc.)
└── assets/      # Static CSS, JS, images (prefer {% stylesheet %}/{% javascript %} instead)