Dive Into Fluid

This is a collection of examples and tutorials for the Fluid templating library.

Fluid is a C# implementation of Liquid, which was originally written by Shopify. There are multiple implementations for Liquid in different languages.

Most Liquid syntax works in Fluid. If something isn’t in this guide, but you can find it in other Liquid documentation, there’s a better-than-random chance it will work the same way in Fluid.

I have tried to be clear about “Liquid” vs. “Fluid.” If something is specified as “Liquid,” then it will likely work in all implementations of the language. Something referenced as “Fluid” is just for this implementation.

I assumed no prior Liquid knowledge or functionality for this guide. For the code here, I pretended there was no Liquid doc – that Fluid was an original, standalone library – and I tested everything in “pure” Fluid (2.2.6, as of this writing)

No matter what the original Liquid doc says, what’s in this guide is gospel for Fluid. All code samples were executed in Fluid.

Also note that this is a guide mainly for C# developers. If you work with Liquid at the templating level, there’s a lot here for you as well, but this guide will dig down into the code under the implementation.

For more on how to address the different types of developers, see Introduction: The Four Levels of Fluid Development.

– Deane