2.4 KiB
title, description, redirect_from
| title | description | redirect_from |
|---|---|---|
| Introduction | An overview of objects, tags, and filters in the Liquid template language. | /basics/ |
Liquid uses a combination of objects, tags, and filters inside template files to display dynamic content.
Objects
Objects contain the content that Liquid displays on a page. Objects and variables are displayed when enclosed in double curly braces: {% raw %}{{{% endraw %} and {% raw %}}}{% endraw %}.
Input
```liquid {%- raw -%} {{ page.title }} {% endraw %} ```Output
```text {{ page.title }} ```In this case, Liquid is rendering the content of the title property of the page object, which contains the text {{ page.title }}.
Tags
Tags create the logic and control flow for templates. The curly brace percentage delimiters {% raw %}{%{% endraw %} and {% raw %}%}{% endraw %} and the text that they surround do not produce any visible output when the template is rendered. This lets you assign variables and create conditions or loops without showing any of the Liquid logic on the page.
Input
```liquid {%- raw -%} {% if user %} Hello {{ user.name }}! {% endif %} {% endraw %} ```Output
```text Hello Adam! ```Tags can be categorized into various types:
- [Control flow]({{ "/tags/control-flow/" | prepend: site.baseurl }})
- [Iteration]({{ "/tags/iteration/" | prepend: site.baseurl }})
- [Template]({{ "/tags/template/" | prepend: site.baseurl }})
- [Variable assignment]({{ "/tags/variable/" | prepend: site.baseurl }})
You can read more about each type of tag in their respective sections.
Filters
Filters change the output of a Liquid object or variable. They are used within double curly braces {% raw %}{{ }}{% endraw %} and [variable assignment]({{ "/tags/variable/" | prepend: site.baseurl }}), and are separated by a pipe character |.
Input
```liquid {%- raw -%} {{ "/my/fancy/url" | append: ".html" }} {% endraw %} ```Output
```text {{ "/my/fancy/url" | append: ".html" }} ```Multiple filters can be used on one output, and are applied from left to right.
Input
```liquid {%- raw -%} {{ "adam!" | capitalize | prepend: "Hello " }} {% endraw %} ```Output
```text {{ "adam!" | capitalize | prepend: "Hello " }} ```