Shopify Liquid MCP Server

# Shopify Liquid Documentation Index Complete reference documentation for Shopify Liquid templating language. **Last Updated:** November 22, 2025 ## Documentation Statistics - **Tags:** 30 complete - **Filters:** 101 complete - **Objects:** 67 complete - **Total Pages:** 198 --- ## Tags (30) Liquid tags are the programming logic that tells templates what to do. ### Control Flow - [if](tags/if.md) - Executes code conditionally - [unless](tags/unless.md) - Executes code unless condition is true - [case](tags/case.md) - Creates a switch statement - [conditional-else](tags/conditional-else.md) - Else clause for conditionals ### Iteration - [for](tags/for.md) - Repeatedly executes a block of code - [break](tags/break.md) - Causes the loop to stop iterating - [continue](tags/continue.md) - Causes the loop to skip to next iteration - [cycle](tags/cycle.md) - Loops through a group of strings - [tablerow](tags/tablerow.md) - Generates table rows - [iteration-else](tags/iteration-else.md) - Else clause for loops - [paginate](tags/paginate.md) - Splits products, articles, or collections ### Variable - [assign](tags/assign.md) - Creates a new variable - [capture](tags/capture.md) - Captures string inside opening and closing tags - [increment](tags/increment.md) - Creates a new number variable and increases its value - [decrement](tags/decrement.md) - Creates a new number variable and decreases its value - [echo](tags/echo.md) - Outputs an expression ### Theme - [layout](tags/layout.md) - Specifies which layout to use - [section](tags/section.md) - Renders a section - [sections](tags/sections.md) - Renders section group - [render](tags/render.md) - Renders a snippet - [include](tags/include.md) - Includes a snippet (deprecated) - [content_for](tags/content_for.md) - Defines content blocks ### HTML/Asset - [form](tags/form.md) - Generates HTML form tags - [style](tags/style.md) - Generates HTML style tag - [stylesheet](tags/stylesheet.md) - Generates stylesheet link tag - [javascript](tags/javascript.md) - Generates script tag ### Syntax - [comment](tags/comment.md) - Prevents code from being executed - [raw](tags/raw.md) - Outputs Liquid code without processing - [liquid](tags/liquid.md) - Allows multiple tags without delimiters - [doc](tags/doc.md) - Documents Liquid code --- ## Filters (101) Filters change the output of a Liquid object or variable. ### String Filters (20) - [append](filters/append.md) - Concatenates two strings - [capitalize](filters/capitalize.md) - Capitalizes first word - [downcase](filters/downcase.md) - Converts string to lowercase - [upcase](filters/upcase.md) - Converts string to uppercase - [escape](filters/escape.md) - Escapes HTML characters - [handleize](filters/handleize.md) - Formats string into handle - [lstrip](filters/lstrip.md) - Removes whitespace from left - [rstrip](filters/rstrip.md) - Removes whitespace from right - [strip](filters/strip.md) - Removes whitespace from both sides - [strip_html](filters/strip_html.md) - Removes HTML tags - [strip_newlines](filters/strip_newlines.md) - Removes newline characters - [newline_to_br](filters/newline_to_br.md) - Replaces newlines with `<br>` tags - [pluralize](filters/pluralize.md) - Outputs singular or plural version - [prepend](filters/prepend.md) - Prepends string to another - [remove](filters/remove.md) - Removes all occurrences - [remove_first](filters/remove_first.md) - Removes first occurrence - [replace](filters/replace.md) - Replaces all occurrences - [replace_first](filters/replace_first.md) - Replaces first occurrence - [slice](filters/slice.md) - Returns substring - [split](filters/split.md) - Divides string into array - [truncate](filters/truncate.md) - Shortens string to character limit - [truncatewords](filters/truncatewords.md) - Shortens string to word limit - [url_decode](filters/url_decode.md) - Decodes URL-encoded string - [url_encode](filters/url_encode.md) - URL-encodes string ### Array Filters (13) - [compact](filters/compact.md) - Removes nil values from array - [concat](filters/concat.md) - Concatenates arrays - [first](filters/first.md) - Returns first item - [join](filters/join.md) - Combines array items into string - [last](filters/last.md) - Returns last item - [map](filters/map.md) - Extracts property values into array - [reverse](filters/reverse.md) - Reverses array order - [size](filters/size.md) - Returns array or string size - [sort](filters/sort.md) - Sorts array - [sort_natural](filters/sort_natural.md) - Sorts array case-insensitively - [uniq](filters/uniq.md) - Removes duplicate items - [where](filters/where.md) - Filters array by property value ### Math Filters (11) - [abs](filters/abs.md) - Returns absolute value - [at_least](filters/at_least.md) - Limits value to minimum - [at_most](filters/at_most.md) - Limits value to maximum - [ceil](filters/ceil.md) - Rounds up to nearest integer - [floor](filters/floor.md) - Rounds down to nearest integer - [round](filters/round.md) - Rounds to nearest integer or decimal - [divided_by](filters/divided_by.md) - Divides number - [minus](filters/minus.md) - Subtracts number - [plus](filters/plus.md) - Adds number - [times](filters/times.md) - Multiplies number - [modulo](filters/modulo.md) - Returns remainder of division ### Money Filters (4) - [money](filters/money.md) - Formats money with currency - [money_with_currency](filters/money_with_currency.md) - Formats money with currency symbol - [money_without_currency](filters/money_without_currency.md) - Formats money without currency - [money_without_trailing_zeros](filters/money_without_trailing_zeros.md) - Formats money without trailing zeros ### Image Filters (5) - [image_tag](filters/image_tag.md) - Generates image tag - [image_url](filters/image_url.md) - Generates image URL - [img_tag](filters/img_tag.md) - Generates img tag (deprecated) - [img_url](filters/img_url.md) - Generates image URL (deprecated) - [placeholder_svg_tag](filters/placeholder_svg_tag.md) - Generates placeholder SVG ### Color Filters (9) - [color_brightness](filters/color_brightness.md) - Adjusts color brightness - [color_darken](filters/color_darken.md) - Darkens color - [color_lighten](filters/color_lighten.md) - Lightens color - [color_desaturate](filters/color_desaturate.md) - Desaturates color - [color_saturate](filters/color_saturate.md) - Saturates color - [color_mix](filters/color_mix.md) - Mixes two colors - [color_to_hex](filters/color_to_hex.md) - Converts to hex - [color_to_hsl](filters/color_to_hsl.md) - Converts to HSL - [color_to_rgb](filters/color_to_rgb.md) - Converts to RGB ### URL Filters (12) - [asset_url](filters/asset_url.md) - Generates asset URL - [file_url](filters/file_url.md) - Generates file URL - [global_asset_url](filters/global_asset_url.md) - Generates global asset URL - [link_to](filters/link_to.md) - Generates HTML link - [link_to_type](filters/link_to_type.md) - Generates link to product type - [link_to_vendor](filters/link_to_vendor.md) - Generates link to vendor - [shopify_asset_url](filters/shopify_asset_url.md) - Generates Shopify asset URL - [within](filters/within.md) - Generates URL within collection - [script_tag](filters/script_tag.md) - Generates script tag - [stylesheet_tag](filters/stylesheet_tag.md) - Generates stylesheet link tag ### Media Filters (4) - [external_video_tag](filters/external_video_tag.md) - Generates external video tag - [media_tag](filters/media_tag.md) - Generates media tag - [model_viewer_tag](filters/model_viewer_tag.md) - Generates 3D model viewer - [video_tag](filters/video_tag.md) - Generates video tag ### Payment & Icon Filters (2) - [payment_type_img_url](filters/payment_type_img_url.md) - Generates payment icon URL - [payment_type_svg_tag](filters/payment_type_svg_tag.md) - Generates payment SVG tag ### Utility Filters (15) - [date](filters/date.md) - Formats date - [default](filters/default.md) - Sets default value - [default_errors](filters/default_errors.md) - Generates default error messages - [default_pagination](filters/default_pagination.md) - Generates default pagination - [format_address](filters/format_address.md) - Formats postal address - [highlight](filters/highlight.md) - Wraps search terms with HTML - [highlight_active_tag](filters/highlight_active_tag.md) - Highlights active tag - [json](filters/json.md) - Converts to JSON - [time_tag](filters/time_tag.md) - Generates time HTML tag - [weight_with_unit](filters/weight_with_unit.md) - Formats weight with unit ### Encoding & Crypto Filters (7) - [base64_decode](filters/base64_decode.md) - Decodes base64 - [base64_encode](filters/base64_encode.md) - Encodes to base64 - [hmac_sha1](filters/hmac_sha1.md) - Generates HMAC SHA1 hash - [hmac_sha256](filters/hmac_sha256.md) - Generates HMAC SHA256 hash - [md5](filters/md5.md) - Generates MD5 hash - [sha1](filters/sha1.md) - Generates SHA1 hash - [sha256](filters/sha256.md) - Generates SHA256 hash ### Customer & Translation Filters (4) - [customer_login_link](filters/customer_login_link.md) - Generates customer login link - [customer_logout_link](filters/customer_logout_link.md) - Generates customer logout link - [customer_register_link](filters/customer_register_link.md) - Generates customer register link --- ## Objects (67) Liquid objects contain attributes that output dynamic content on the page. ### Core Store Objects (4) - [shop](objects/shop.md) - Information about the store - [settings](objects/settings.md) - Theme settings - [theme](objects/theme.md) - Current theme information - [brand](objects/brand.md) - Store brand information ### Product Objects (6) - [product](objects/product.md) - Product information - [variant](objects/variant.md) - Product variant information - [product_option](objects/product_option.md) - Product option information - [collection](objects/collection.md) - Product collection - [collections](objects/collections.md) - All collections - [all_products](objects/all_products.md) - All products in store ### Cart & Checkout Objects (4) - [cart](objects/cart.md) - Shopping cart - [line_item](objects/line_item.md) - Cart/order line item - [checkout](objects/checkout.md) - Checkout information - [order](objects/order.md) - Order information ### Customer Objects (5) - [customer](objects/customer.md) - Customer information - [customer_payment_method](objects/customer_payment_method.md) - Customer payment method - [address](objects/address.md) - Customer address - [company](objects/company.md) - B2B company information - [company_location](objects/company_location.md) - B2B company location ### Content Objects (7) - [page](objects/page.md) - Page information - [blog](objects/blog.md) - Blog information - [article](objects/article.md) - Blog article - [articles](objects/articles.md) - All articles - [comment](objects/comment.md) - Blog comment - [link](objects/link.md) - Navigation link - [linklist](objects/linklist.md) - Navigation menu ### Media Objects (7) - [image](objects/image.md) - Image object - [media](objects/media.md) - Media object - [video](objects/video.md) - Video object - [model](objects/model.md) - 3D model object - [external_video](objects/external_video.md) - External video (YouTube/Vimeo) - [image_presentation](objects/image_presentation.md) - Image presentation - [generic_file](objects/generic_file.md) - Generic file object ### Metafield & Custom Data Objects (4) - [metafield](objects/metafield.md) - Metafield information - [metaobjects](objects/metaobjects.md) - All metaobjects - [metaobject](objects/metaobject.md) - Metaobject entry - [metaobject_definition](objects/metaobject_definition.md) - Metaobject definition ### Selling Plan Objects (3) - [selling_plan](objects/selling_plan.md) - Subscription selling plan - [selling_plan_group](objects/selling_plan_group.md) - Selling plan group - [selling_plan_allocation](objects/selling_plan_allocation.md) - Selling plan allocation ### Discount & Pricing Objects (4) - [discount](objects/discount.md) - Discount code - [discount_application](objects/discount_application.md) - Applied discount - [tax_line](objects/tax_line.md) - Tax information - [taxonomy_category](objects/taxonomy_category.md) - Product taxonomy ### Localization Objects (5) - [localization](objects/localization.md) - Localization information - [shop_locale](objects/shop_locale.md) - Shop locale - [country](objects/country.md) - Country information - [currency](objects/currency.md) - Currency information ### Request & Navigation Objects (5) - [request](objects/request.md) - Current request information - [routes](objects/routes.md) - Store routes/URLs - [search](objects/search.md) - Search results - [paginate](objects/paginate.md) - Pagination information - [forloop](objects/forloop.md) - For loop iteration information ### Filter & Sort Objects (3) - [filter](objects/filter.md) - Collection filter - [filter_value](objects/filter_value.md) - Filter value option - [sort_option](objects/sort_option.md) - Sort option ### Section & Block Objects (2) - [section](objects/section.md) - Theme section - [block](objects/block.md) - Section block ### App & Script Objects (2) - [app](objects/app.md) - App information - [script](objects/script.md) - Shopify Script (deprecated) ### Shipping & Fulfillment Objects (2) - [shipping_method](objects/shipping_method.md) - Shipping method - [transaction](objects/transaction.md) - Payment transaction ### Gift Card & Special Objects (4) - [gift_card](objects/gift_card.md) - Gift card information - [recommendations](objects/recommendations.md) - Product recommendations - [store_credit_account](objects/store_credit_account.md) - Store credit account - [user](objects/user.md) - User information - [policy](objects/policy.md) - Store policy --- ## Quick Reference ### Most Common Tags - `{% if %}`, `{% for %}`, `{% assign %}`, `{% render %}`, `{% section %}` ### Most Common Filters - `{{ product.title | upcase }}`, `{{ product.price | money }}`, `{{ collection.image | image_url }}` ### Most Common Objects - `product`, `collection`, `cart`, `customer`, `shop`, `page`, `article` --- ## Documentation Structure ``` shopify-liquid-docs/ ├── tags/ 30 tag documentation files ├── filters/ 101 filter documentation files ├── objects/ 67 object documentation files ├── INDEX.md This file └── README.md Documentation overview ``` --- ## Additional Resources - [Official Shopify Liquid Documentation](https://shopify.dev/docs/api/liquid) - [Liquid Template Language](https://shopify.github.io/liquid/) - [Shopify Theme Development](https://shopify.dev/themes) --- **Note:** This documentation was downloaded from shopify.dev on November 22, 2025. For the most up-to-date information, always refer to the official Shopify documentation.