Skip to content

Liquid Reference

The /shopify-liquid skill gives Claude deep knowledge of Shopify's Liquid templating language — syntax, filters, tags, objects, schema settings, LiquidDoc, and translation conventions.

Invoke

/shopify-liquid

The skill also activates implicitly when you ask Claude to write or edit .liquid files, work with schema JSON, or look up Liquid APIs.

What it knows

The skill loads a comprehensive reference covering:

  • Liquid syntax — delimiters, operators, whitespace trimming, variables, critical gotchas (no parentheses, no ternary, 50-iteration loop limit)
  • 152 filters — array, string, math, money, color, media, URL, HTML, localization
  • 30 tags — theme, control flow, iteration, variable, HTML, documentation
  • Global and page-specific objectscart, product, collection, customer, and all template-scoped objects
  • 33 schema setting types — decision table for choosing the right type, visible_if patterns, block entry types
  • LiquidDoc ({% doc %}) — param types, optional vs required, @example blocks
  • Translation conventionst filter usage, variable interpolation, locale file structure, key naming
  • JSON template editingjq-based patterns for safe template and config modifications

Example prompts

  • "Create a section schema with an image picker, color setting, and range slider"
  • "What filters can I chain to format a product price with currency?"
  • "Write a LiquidDoc header for a snippet that accepts a product and a boolean"
  • "How do I use visible_if to conditionally show a setting?"
  • "Convert these hardcoded strings to use translation keys"

Composes with

SkillWhy
/shopify-liquid-a11yAdd WCAG 2.2 patterns to Liquid components
/shopify-liquid-kona-standardsFollow Kona's CSS/JS/HTML conventions
/shopify-liquid-kona-newCreate new sections/blocks/snippets with correct schema
/shopify-liquid-translatorGenerate translations for locale keys

Next steps