Public Swift documentation

Liquid templates, written in Swift.

Render with typed values and reusable templates. Compose explicit partials, add engine-scoped filters, inspect dependencies and measure the work you choose to observe.

Swift 6.4+ · Swift language mode 6 · Liquid library and liquid CLI · No root package dependencies

Explore the complete API reference

Start with Swift

Install the package, supply typed context and render your first template.

Getting started

Use the command line

Render files, validate syntax and write explicit analysis or metrics reports.

CLI guide

Render and compose

Reuse parsed templates and pass partials explicitly, with clear scope and escaping rules.

Rendering and partials

Inspect before rendering

Read syntactic references and bounded partial dependencies without evaluating the template.

Partial dependencies

Measure and bound work

Understand opt-in timing, cumulative logical quotas and cooperative cancellation.

Render metrics

Review compatibility

Follow independent fixtures, Shopify reference comparisons and the limits of qualification.

Testing and conformance

A focused engine, with inspectable evidence

The language target is Shopify's open-source Liquid core. Qualification combines the independent Golden Liquid corpus, pinned Ruby reference comparisons, public consumers, Swift Testing and sanitizers. Published evidence distinguishes successful renders, expected failures and unsupported boundaries.

Runtime qualification covers macOS with separate Apple simulator compilation. Read the limits and concurrency contract before selecting an operation profile.

These pages track main and deploy after all eight release lanes pass. For a released version's exact documentation, use its compiled DocC archive. Build source: fb81cf4ff01f. Build information.