---
title: LiquidDoc for snippets and blocks - Shopify developer changelog
description: >-
  Shopify’s developer changelog documents all changes to Shopify’s platform.
  Find the latest news and learn about new platform opportunities.
source_url:
  html: 'https://shopify.dev/changelog/posts/liquiddoc-for-snippets-and-blocks'
  md: 'https://shopify.dev/changelog/posts/liquiddoc-for-snippets-and-blocks.md'
metadata:
  effectiveApiVersion: ''
  affectedApi: []
  primaryTag:
    displayName: Themes
    handle: dev_themes
  secondaryTag:
    displayName: New
    handle: new
  indicatesActionRequired: false
  createdAt: '2025-05-20T16:57:12-04:00'
  postedAt: '2025-05-21T08:00:00-04:00'
  updatedAt: '2025-05-20T17:00:20-04:00'
  effectiveAt: '2025-05-21T08:00:00-04:00'
---

May 21, 2025

# LiquidDoc for snippets and blocks

DateMay 21, 2025

FlagsNew

SurfacesThemes

LiquidDoc is a new way to add structured documentation directly within your Liquid snippets, and blocks. Define clear input parameters, include helpful descriptions, and provide practical usage examples right alongside your Liquid code.

LiquidDoc integrates seamlessly with theme checks, code completions, and hover information, helping you catch common mistakes - like missing or misspelled parameters - before they become issues. This makes theme development faster, simpler, and more reliable.

Learn more in the [official LiquidDoc documentation](https://shopify.dev/docs/storefronts/themes/tools/liquid-doc).