Filters

A filter changes a value: {{ 'kopi' | upcase }}. Chain them left to right ({{ name | strip | capitalize }}), and give arguments after a colon (truncate: 30). Named arguments are written name: value, like icon: class: 'size-5'. See language for the syntax.

Rules that apply to every filter:

• Filters are forgiving about missing values: a nil becomes empty text and a bad number becomes 0.
• A filter's result is escaped when written out, except for icon, markdown and newline_to_br, which return markup the platform built.
• Lists a filter produces are capped at 5000 items (split, paragraphs, lines, concat).
• An unknown filter name is a save-time error.
• Filters can't be used inside if conditions. assign the result first.

Outputs below are shown as they appear on the page. The examples assume the website's language is Indonesian (id) and its WhatsApp number is 6281234567890.

#Text filters

default takes one named argument: allow_false: true keeps a real false instead of replacing it: {{ flag | default: 'x', allow_false: true }}.

paragraphs and split return lists, which a for loop can't filter directly. Assign first:

{% assign paras = s.text | paragraphs %}
{% for p in paras %}<p>{{ p }}</p>{% endfor %}

#Date formats

date accepts a text like 2026-11-08 or a full ISO date (2026-11-08T14:05:09Z), a number (seconds, or milliseconds when very large), or the words now and today. Dates are in UTC. Text it can't read is returned unchanged. Without a format it uses %e %B %Y. Month and day names follow the language of the page: Minggu and November in Indonesian, Sunday and November in English.

{{ '2026-11-08' | date: '%d/%m/%Y' }}
Hak cipta {{ 'now' | date: '%Y' }}

#Number filters

Numbers are read the way prices are written in Indonesia: '12' is 12, 'Rp 25.000' is 25000 (dots between groups of three digits are thousands), '1.500.000,50' is 1500000.5 and '1,5' is 1.5. '1.5' and '25,000.50' work too. Anything unreadable is 0.

divided_by rounds down only when both numbers are whole: {{ 10 | divided_by: 4 }} is 2, {{ 7.5 | divided_by: 2 }} is 3.75. 4.0 counts as a whole number, so to get a fraction from whole numbers multiply instead: {{ 10 | times: 0.25 }} is 2.5. A number is written with at most 10 decimals.

#List filters

Most also work on text, or turn a single value into a one-item list. key can be a dotted path such as 'price.value'.

{% assign popular = s.plans | where: 'featured' %}
{% assign cheapest = s.plans | sort: 'price' | first %}
Mulai dari {{ cheapest.price | money }}

#Plangku filters

#link

{{ value | link }} turns a stored link (wa:Halo, page:tentang, #kontak, tel:..., mailto:..., a web address) into a link object. It prints the address and has .href, .kind and .external. Empty values stay empty.

{% assign to = 'wa:Halo, mau tanya' | link %}
<a href="{{ to }}">{{ to.kind }}</a>

Output: <a href="https://wa.me/6281234567890?text=Halo%2C%20mau%20tanya">whatsapp</a>. {{ 'page:' | link }} is the home page.

#whatsapp_url

{{ 'Halo, mau pesan' | whatsapp_url }} gives https://wa.me/6281234567890?text=Halo%2C%20mau%20pesan: a chat with the business, using the number from the website settings, with the text typed in. It returns plain text (an address), not a link object. In translated versions the message you wrote in a template stays as written; messages stored in link settings are translated.

#money

{{ 25000 | money }} gives Rp 25.000. A number, or text made of digits and dots ('25.000', where dots are thousands separators), is formatted in rupiah. Any other text is returned unchanged. Collection item prices (item.price) are already formatted, so only use money on numbers from your own settings.

#icon

{{ 'Truck' | icon }} draws an icon as inline SVG that takes the colour of the text (currentColor).

{{ 'ShoppingBag' | icon: class: 'size-5', stroke: 1.75 }}
{{ s.icon | icon: class: 'card-icon', fallback: 'Sparkles' }}
{{ 'whatsapp' | icon: class: 'size-5' }}

Names are the ones in the editor's icon picker (about 220 line icons, for example Truck, ShieldCheck, MessageCircle, ShoppingBag, Star, Phone, MapPin, Check, ArrowRight, Menu). Both ShoppingBag and shopping-bag work. A name that isn't an icon draws nothing unless you give a fallback.

Brand names are matched first, in lowercase, and draw a filled logo instead of a line icon: instagram, tiktok, facebook, youtube, whatsapp, x, threads, shopee, gojek, grab. Brand icons ignore stroke, and without a class they are size-5.

#t

{{ 'Lihat semua' | t }} writes the text in the visitor's language. See translations. The text should be a literal in the template so Plangku can collect it. Without a translation the original text is shown.

#ui

{{ 'contact' | ui }} writes a word the platform already knows in the page's language (Kontak in Indonesian, Contact in English). Use one of the keys below; an unknown key is written out as it is. Placeholders such as {brand} are not filled in, so madeWith, order and captchaLabel are not very useful in themes.

The form messages are also available: formRequired, formEmail, formPhone, formNumber, formDate, formTime, formChoice, formSelect, formCheck, captchaLabel, captchaHelp, captchaWrong, formRetry, formBusy, formFailed, formGone, formAnother, formWhatsapp, formWhatsappText and formPreview. Themes can't build forms (see security), so you will rarely need them.

#markdown

{{ s.text | markdown }} turns Markdown text into safe HTML. The text is escaped first, and only these things are produced: ## and ### headings, - bullets, 1. numbered lists, > quotes, ---, **bold**, *italic*, [links](https://...) and ![photos](https://...).

{{ '**Gratis** ongkir untuk [semua kota](/produk)' | markdown }}

Output: <p><strong>Gratis</strong> ongkir untuk <a href="/produk">semua kota</a></p>

#section_vars

{{ 'brand' | section_vars }} returns the colour variables of a section background (base, surface, brand or inverse; anything else means base) as text for a style attribute: --s-bg, --s-fg, --s-muted, --s-line, --s-card, --s-hl, --s-hl-fg, --s-btn, --s-btn-fg and --s-btn-soft. Use it to give one block inside a section a different background than the section itself. See styling.

<div class="band" style="{{ 'inverse' | section_vars }}">...</div>

.band { background: var(--s-bg); color: var(--s-fg); }

#asset_url

{{ 'logo.png' | asset_url }} is the address of an image uploaded with a theme package (assets/logo.png). With or without the assets/ prefix. Unknown files give empty text. Only image files can be assets (png, jpg, jpeg, webp, gif, avif).

<img src="{{ 'logo.png' | asset_url }}" alt="{{ site.name }}">

#youtube_id

{{ 'https://youtu.be/dQw4w9WgXcQ' | youtube_id }} gives dQw4w9WgXcQ. It understands watch?v=, youtu.be/, shorts/, embed/ and live/ addresses, and returns empty text for anything else. Use it for an embed:

{% assign id = s.video | youtube_id %}
{% if id != blank %}
  <iframe src="https://www.youtube-nocookie.com/embed/{{ id }}" title="Video" loading="lazy" allowfullscreen></iframe>
{% endif %}

#image_url

{{ s.photo | image_url }} returns the address when it is an uploaded image (/uploads/...) or an https:// address, and empty text otherwise (http:, javascript: and everything else are dropped). Image settings are already filtered this way. Use it for a collection item's image or any text you built yourself.

#Not in Plang

If a filter isn't listed on this page it doesn't exist. Commonly missed ones from Liquid are money_with_currency, img_url, base64_encode, md5, find and reject. where only compares for equality, and t takes no variables, so build the sentence from settings or from several t texts instead.