Skip to main content

About Us

How HTML2Liquid approaches HTML conversion, Shopify schema, testing, and practical theme-development documentation.

What HTML2Liquid is

HTML2Liquid is a free set of Shopify theme-development tools: a deterministic HTML-to-section converter, an optional AI-assisted converter, a visual section-schema builder, a Liquid cheatsheet with a learning playground, and an original tutorial library.

It was created to reduce the repetitive first pass of turning a static design fragment into merchant-editable Liquid. The project keeps that generated code visible and copyable so a developer can inspect the content model instead of treating conversion as a black box.

Who maintains it

Lavkush Varma builds and maintains the application and its documentation. Work represented in this repository includes HTML parsing, Liquid generation, section schema, blocks, image handling, authentication, accessibility improvements, automated tests, and Shopify theme-development tutorials.

How guidance is checked

Tutorials are written around reproducible examples, validated with automated JSON and Liquid checks where possible, and linked to relevant Shopify developer documentation. Platform behavior can change, so readers should confirm version-sensitive rules in the official documentation and a development theme.

Project limitations

  • Static HTML cannot describe a theme's existing CSS, JavaScript, snippets, translations, app blocks, or resource data.
  • Repeated markup can suggest a block model, but only the developer knows whether the correct source is a section block, theme block, collection, metafield, or metaobject.
  • Generated code is not guaranteed to work without review, and AI-assisted output can contain invalid or unsuitable choices.
  • The cheatsheet playground uses mock data and a learning-oriented Liquid runtime; it is not a substitute for Shopify's storefront renderer.

Report incorrect output or documentation

Use the contact form for conversion bugs, incorrect documentation, or accessibility problems. A useful report includes a reduced HTML example, the conversion mode, the generated result, what you expected, and any Theme Check or theme-editor error.

Report a problem