Writing  ›  Topics

Shopify Liquid

Liquid is the language Shopify themes are built in, and clean Liquid is what replaces a slow app with code that loads faster. These are my Liquid references, theme development guides, section schema patterns, metaobject and metafield setups, and Shopify Functions and CLI walkthroughs, all written to be copied into a real theme and shipped.

All Apps CRO Performance Liquid SEO Agentic AI Plus

57 posts in Liquid

All writing →

  1. Shopify CLI Cheat Sheet: theme dev, CI Auth, check and console

    Shopify theme dev non-interactive? This Shopify CLI cheat sheet covers CI auth with SHOPIFY_CLI_THEME_TOKEN and SHOPIFY_FLAG_STORE, theme check, console, push, plus a free PDF.

  2. WooCommerce to Shopify Migration: The Honest 2026 Guide

    A WooCommerce to Shopify migration guide from an independent developer: real 2026 costs, the 301 redirect map that saves your rankings, what actually breaks, and a free checklist.

  3. Shopify Liquid Cheat Sheet: The Filters, Tags and Objects You Actually Use

    A working Shopify Liquid cheat sheet: the filters, tags, objects, and price and image formatting you use on real themes, with copy-paste code and a free one-page PDF.

  4. How to Refund Shipping on Shopify (Without Refunding the Whole Order)

    How to refund shipping on Shopify: the exact Orders > Refund flow, partial shipping refunds, and the store credit option that keeps cash in your business.

  5. Remove 'Shipping Calculated at Checkout' on Shopify (3 Real Fixes)

    How to remove the shipping calculated at checkout message on Shopify: edit the theme string, show real expectations, or replace it with a free shipping bar.

  6. Shopify Countdown Timer Without an App: Copy-Paste Code (2026)

    Add a countdown timer bar to any Shopify OS 2.0 theme with one copy-paste section: schema, markup, CSS, and vanilla JS. No app, no monthly fee, no layout shift, plus the password page setup and when a timer helps or hurts conversion.

  7. Shopify Scripts Stopped Working on June 30: The Triage Guide

    Shopify Scripts were deactivated on June 30, 2026. What actually breaks, the 5-minute check, the July 30 Script Editor deadline for recovering your code, the fastest stopgap, and the Functions rebuild path.

  8. Shopify Magic in 2026: What It Does, and How to Make It Convert

    Shopify Magic is free AI built into every plan: product descriptions, blog posts, email, images, and Sidekick. What it actually does in 2026, its real limits, and how to edit its output so it converts and gets cited by AI.

  9. Shopify Horizon vs Dawn in 2026: Migrate or Stay?

    Horizon is Shopify's blocks-first flagship theme. There is no automatic migration from Dawn, so moving is a full rebuild. A CRO specialist on when switching is worth the layout-shift risk and when it is not.

  10. Shopify Spring '26 Editions: 8 Changes That Move Conversion

    Shopify shipped 150+ updates on June 17, 2026 in the Spring '26 Edition (often searched as the Summer 2026 edition): the 8 that move revenue, ranked by a CRO specialist, plus the June 30 Scripts deadline that breaks Plus stores.

  11. Shopify Theme Dev Command: Flags, Tokens, and Non-Interactive CI

    SHOPIFY_CLI_THEME_TOKEN is set but shopify theme dev still opens a browser login in CI. See the flag most guides skip, plus a working non-interactive example.

  12. Shopify shop.vendors Limit: There Is No 30 Cap (The Real Story)

    Every dev has heard shop.vendors caps at 30 in Shopify Liquid. The docs say otherwise, and a short vendor list has a different cause most tutorials get wrong.

  13. Shopify Theme Check Path Argument: Use --path, Not a Positional

    A path argument right after shopify theme check used to work. CLI 3.0 changed the rule, most docs skip why yours fails. Get the exact syntax and a CI example.

  14. Shopify Font Loading: Kill FOIT and FOUT Without the CLS Tax (2026)

    Fix Shopify font FOIT and FOUT with font-display, size-adjust, and ascent-override. Eliminate CLS from font swap. Works with Dawn, OS 2.0, and Google Fonts.

  15. Shopify CLS Survival Guide: 6 Layout Shift Killers in Liquid Themes (2026)

    The 6 patterns that produce 90% of Shopify CLS failures: unsized images, font swap shift, JS-injected hero, sticky-header CLS, dynamic banners, and review widget hydration. Liquid fix per pattern.

  16. Sub-2s TTFB on Shopify: When Liquid Loops Cost You Real Money (2026)

    Most Shopify TTFB problems are not Shopify's fault. 4 Liquid patterns that push TTFB past 2 seconds: nested for loops, all_products iteration, metafield N+1, deep section recursion. The fix per pattern.

  17. Shopify Sub-1s LCP: 3 Hugo-Style Tricks Liquid Themes Can Steal (2026)

    How to hit sub-1-second LCP on a Shopify theme using 3 tricks borrowed from static site generators: critical CSS inline, image_url with srcset and fetchpriority, and preload hints for the hero asset.

  18. Microsoft Clarity AI Visibility: How to Read Citation Data for Your Shopify Store (2026)

    Install and read Microsoft Clarity AI Visibility on Shopify: the 4 panels, share of authority math, and what each citation pattern means in 2026.

  19. Shopify Robots.txt for AI Crawlers: Allow GPTBot, ClaudeBot, PerplexityBot in 2026

    9 of 38 Shopify stores I audited block at least one AI crawler at robots.txt. The 6 user-agents to allow, the Liquid override, and the curl verification.

  20. Shopify Data Quality for AI Citation: The Complete Audit (2026)

    The complete Shopify data-quality audit for AI citation. Data layer (9 fields agents scrape via UCP), schema validity (4 errors that block citation), and identifier coverage (GTIN audit + bulk fix).

  21. PageFly vs Shogun vs GemPages: The Speed Cost (2026)

    PageFly vs Shogun vs GemPages: I measured what each page builder costs in main-thread blocking time and monthly fees. The speed ranking is not the one they publish.

  22. How Shopify Agentic Storefronts Work: UCP Mechanics, Shop Pay, and the 3-Layer Flow (2026)

    The 3-layer mechanic behind Shopify Agentic Storefronts: UCP catalogue exposure, agent query and ranking, Shop Pay checkout. How each layer works in 2026.

  23. Shopify Agentic Storefronts Catalogue Optimisation (UK Stores, 2026)

    UK Shopify stores need GBP money filters, VAT-inclusive pricing, EAN-13 GTINs, and Royal Mail rates exposed to AI agents. 8 fixes that move UK SoA up.

  24. Hydrogen vs Liquid in 2026: When Headless Actually Wins

    Independent take from a 12-year Liquid dev. The 5% where Hydrogen earns its complexity, the 95% where it is a tax, and the CrUX numbers that prove it.

  25. Shopify image_url Filter: Sizes, Crop, Format (Complete 2026 Reference)

    Migrating img_url to image_url filter seems like find and replace, until one default breaks srcset. The parameter reference and fix, plus a free cheat sheet.

  26. Shopify Liquid Comments: 3 Syntaxes That Survive Theme Editor

    Liquid gives you three ways to comment out code, but only one survives the theme editor without leaking notes to view-source. See which syntax is safe to ship.

  27. Shopify Liquid For Loop Break and Continue: 5 Working Patterns

    Shopify Liquid break/continue look simple until nested loops hit one pattern that fails silently. All 5 working patterns, the gotcha, and the Dawn fix.

  28. Shopify Liquid Unless Tag: When to Use vs If (Examples + Gotchas)

    Shopify Liquid unless looks like if flipped, until render tag scope hides a variable and it misfires. 4 places it wins, 2 where it should not ship, the fix.

  29. Shopify Metaobjects vs Metafields: When to Use Which (2026)

    Metafields hold a value on one resource. Metaobjects hold structured records reusable across the store. 7 use cases mapped to the right tool. 2026.

  30. Shopify Section Schema Settings: Every Input Type with Working Examples

    Add a default to a section schema setting and Shopify throws FileSaveError before it saves. See every setting type and the one rule that trips people up.

  31. Shopify's Hidden 250-Variant Liquid Cap (And the Fix)

    Shopify lifted variants to 2,048 but product.variants in Liquid still caps at 250. Detect the silent cutoff and ship one of three production fixes.

  32. Free Shipping Progress Bar in Liquid (No App, Markets-Safe)

    Production-grade free shipping progress bar in Liquid. Markets-safe currency, cart event-driven, server-rendered, $0 a month vs $19 app. 90-line section.

  33. Stacking Shopify Discounts in 2026: Functions Code

    Stack BOGO, sitewide percent off, and free shipping in one Shopify cart with Discount Functions. Real code, 2026-04 API, combinesWith, 25-Function cap.

  34. Shopify INP Fix: 612ms to 178ms (Real Store Case Study)

    Real Shopify Plus INP case study: p75 INP from 612ms to 178ms in 5 days. Diagnosed long tasks, patched JavaScript, 28-day CrUX delta. Passing Core Web Vitals.

  35. Building a Tiered Bundle Discount With Shopify Functions

    A 3-tier bundle discount using Shopify Functions, end to end. The 31-line function, the combinesWith trap that kills code discounts, and the cart wiring.

  36. Non-Plus Checkout Extensibility: Aug 26 2026 Migration

    August 26 2026 sunsets checkout.liquid for Basic, Shopify, Advanced. Migrate Additional Scripts, GA4, and pixels with a 5-week non-Plus migration plan.

  37. Shopify .value Accessor: How Metafields Render in Liquid

    Why product.metafields.custom.x.value returns blank, what each metafield type actually returns, and the != blank guard that stops empty-table layout shifts.

  38. Shopify Liquid Operator Precedence: Why and / or Breaks Your if-Statement (2026)

    Liquid evaluates `and` and `or` right to left, not by precedence. Why your nested if returns the wrong result, and the 3-line fix for production.

  39. Shopify Product Configurator (No App): 13-Variant PDP With Full Liquid + JS Code

    Build a Shopify product configurator without a $99-$399 app. The Liquid + JS pattern from a 13-parent Factory Direct Blinds rollout. Full code, 2026.

  40. 5 Real Shopify Scripts I Migrated to Functions (Code)

    5 production Shopify Scripts to Functions migrations, Ruby in, JavaScript out: tiered shipping, free gifts, B2B tags, BXGY, payment hiding. All code included.

  41. Shopify Scripts Die June 30 2026: Migrate to Functions

    Shopify Scripts shut off June 30 2026. Edits froze April 15. Map line item, payment, and delivery Scripts to Functions in 8 weeks. Migration map included.

  42. Liquid Render Tag Syntax: with, for, Named Params (2026)

    A variable passed into a Liquid snippet via render should just work, until scope isolation drops it silently. One rule fixes it, plus a free Liquid cheat sheet.

  43. Script Tags in Shopify Custom Liquid Sections: 4 Working Patterns

    Custom Liquid sections look like they block script tags, until the editor proves otherwise. See which patterns survive a reload, plus a free Liquid cheat sheet.

  44. Shopify Agentic Storefronts: What the May 30 UCP Cutover Changed

    Shopify retired the legacy MCP endpoint at the May 30, 2026 UCP cutover. What changed, plus the 5-step checklist to stay visible in ChatGPT, Perplexity, and Gemini.

  45. Lighthouse vs CrUX: Why Shopify Scores 23 But Passes CWV

    Lighthouse vs CrUX on Shopify: a real Plus store scored 23 on mobile while passing every Core Web Vital in CrUX. Why the gap exists and when to worry.

  46. Shopify Core Web Vitals 2026: Fix LCP, INP, CLS in a Week

    22.0s to 2.7s LCP, mobile PageSpeed 38 to 81. The exact Liquid code, image fixes, and INP cuts that did it on one Shopify client. 30-min audit, week-long fix.

  47. 10 Shopify Custom Liquid Code Examples That Replace Apps (2026)

    10 copy-paste Shopify Liquid code examples with full section schema JSON, a working cheat sheet: testimonials, FAQ, comparison tables, sticky ATC, countdown. Replace Yotpo, Shogun, Klaviyo and save $170/mo.

  48. Fix Hardcoded Prices in Shopify Markets (Liquid + money)

    38 hardcoded prices broke Shopify Markets on one Everly store. The Liquid money-filter audit and fix that dropped CLS from 0.11 to 0.00 on the next deploy.

  49. Shopify Year-Make-Model Vehicle Fitment Selector (Without an App)

    Build a Year/Make/Model vehicle fitment selector on Shopify without an app. Auto-skip logic, dynamic metafields, full Liquid plus JS code. 2026 Dawn-compatible.

  50. Shopify Sticky Add to Cart Button: Copy-Paste Code (No App)

    The copy-paste sticky add to cart button code for Shopify: Liquid markup, scoped CSS, IntersectionObserver JS, zero CLS, and real scroll depth data. No app required.

  51. Shopify Sale Badge: Replace 'Sale' with Save 30% (Liquid)

    Replace the generic Sale badge with Save 30% on every variant. 3 lines of Liquid, works on Dawn, Impulse, Focal. No app, no JS. Drops in under 5 minutes.

  52. Shopify Article Schema in 30 Lines of Liquid

    30-line Liquid snippet that adds valid BlogPosting schema to every Shopify blog post. Restores Google rich results, no SEO app, no $30 per month fee. 2026 spec.

  53. Shopify Agentic Storefronts: Complete Setup Guide (2026)

    Enable Shopify Agentic Storefronts in 7 steps and win AI agent recommendations. Setup, schema, Shop Pay, product copy, tracking, and the mistakes that block citation.

  54. Shopify GEO Guide: Rank in ChatGPT, Perplexity, Google AI

    What Shopify GEO is and how to do it. AI traffic up 8x in 2026. Get cited by ChatGPT, Perplexity, Gemini, and Google AI Overviews. 7 concrete tactics.

  55. Shopify Liquid Loop Optimization (forloop, for, limit)

    Cut Shopify Liquid render time 50 to 70 percent. forloop variables, limit, break, and the Liquid loop patterns that cut LCP from 22s to 2.7s on a real theme.

  56. Shopify Liquid Best Practices 2026: 8 Audit Fails I Find in 100+ Stores

    I audited 100+ Shopify stores and found the same 8 Liquid mistakes in 8 of 10, one silently breaks pricing. Full checklist plus copy-paste fixes for 2026.

  57. Customize Shopify Themes Without Breaking (UK + US)

    14 panicked DMs in 18 months from devs who edited theme code and broke the live site. The duplicate-first workflow that protects every Shopify customisation.

Want a custom CRO analysis for your store?

Skip the blog. I'll walk through your biggest conversion opportunities live.

Book a Call Free 30-min audit · Live store walkthrough · No pitch