Twig functions and filters

Merchant-written Markdown as HTML, with raw markup escaped and executable link targets defused

A storefront sentence as HTML: everything in it escaped, then its links and bold drawn

The same storefront sentence as plain text, with its links and bold taken out, for an attribute, a title, or anywhere a link cannot go

Formats minor units as money, localized to the active language, in the currency you pass or else the visitor's

The credentials page, whose slug is configurable — a theme that hardcodes "/account/profile" breaks on any store that changed it

The customer account route, {base}/account, honouring your configured base

A product's add-on options, priced, in the order the merchant put them

An address as printable lines, laid out for its own country: postcode before the city in Germany, largest unit first in Japan, and the layout the partial always used everywhere else, with the country's name rather than its code on the last line

One attribute's display string, or null when the product does not answer it, for the theme that wants a single fact in the hero rather than the whole table

Where one attribute value's link goes: the shop narrowed to every product answering the same thing

A product's attributes, as the plugin's own product page has them: a list of {slug, label, type, value, display, unit, group, options, filter_url, values} in definition order, holding only the ones marked to show on the product and only where the product has an answer

The signed-in customer's picture as a URL, at the pixel size you ask for

The badges over a product's picture, in the order they are drawn: sold out, pre-order, the sale, the merchant's own badge, download

The configured base route, normalized with a leading slash and no trailing one

The form fields other plugins want inside this product's add-to-cart form, already rendered

How a product's buy button behaves: {on, label}

Total units in the current session's cart, or 0

What other plugins need the customer to read beside a cart or receipt line, keyed by line item id

The storefront's word for the cart, cart, bag or basket (storefront.cart_word), for a theme that picks an icon or a class by it

The whole category tree, nested

A category's picture at the size you ask for, as {url, alt, width, height}, or null when the category has none

Every ISO 3166-1 alpha-2 code with its English name, ordered by name, and the code checkout.default_country names (or '')

The "you are holding a discount code" banner, rendered

The currencies a shopper can pick, for the switcher or a theme's own menu

Keeps an explicit ?currency= choice on an existing site-navigation URL

What to tell a shopper whose cart is in one currency and who followed a link to another

The currency this request is in, and the store's base currency, for the "Not available in EUR" partial or a theme's own line

The custom field values on one row — a product, a variant, an order, an order line, a customer, an address — as a CustomFieldValues object

The customer record the current visitor is, as an array, or null

A date the way the store's language writes one, in the store's timezone: "November 19, 2026" on a US English store, "19 November 2026" on a British one, "19

The country code checkout.default_country names, for preselecting an address form

The signed-in customer's downloads, newest first, for a theme's own library

The express-pay region for the cart page ('cart.express', the default) or the checkout page ('checkout.express'): the wallet buttons every eligible provider registered on onKahunaCartRegisterExpressButtons, each drawn to the merchant's express.* style so they sit in one row at one height

One image at a size of your choosing, as {url, alt, width, height}

What a grouped product or a kit contains

The lightbox's <dialog>, the first time a page asks for it, and nothing after that, so every template that draws an opener can call it

Whether a cart line's quantity is the add-on's rather than the customer's

The Login plugin's own sign-in route, and its logout task on the current page with the nonce that task expects — built exactly the way its own login-status partial builds it

The Login plugin's own sign-in route, and its logout task on the current page with the nonce that task expects — built exactly the way its own login-status partial builds it

Narrows a list of order notices to the ones a template is about to draw

What the customer answered on one order's checkout fields, in the order the form asked them

What an order is called: the reference the order_reference object template stamped on it at completion, or #<number> for an order placed before references existed

Which of an order's statuses the customer is shown, as a list of axis names in the order the account draws them

What a shopper may pay for a pay-what-you-want product, ready for the price box, or null for a product sold at its price

What this visitor gets of a page, for a theme or a listing template that wants to decide for itself

Whether a product is a pre-order, and how to say when it comes out

Formats minor units as money, localized to the active language, in the currency you pass or else the visitor's

Every amount a cart or order summary prints, as one list for the with of kahunacart_price(), so the summary is printed alike: if any amount in it has cents all of them keep them, and if every one is whole none show cents

One published product, or null

Every picture on a product, in gallery order — gallery images and nothing else, which is what this function has always returned and what a theme drawing an <img> with it wants

A product's labels as the storefront draws them, in order: its EU energy labels and its label images

Everything attached to a product, gallery first and then the samples

The Product safety block for a product, as the product route hands it to partials/kahunacart-product-safety.html.twig: {manufacturer, responsible_person, safety_info}, or null when the product has no manufacturer (its own or the store default) and no safety information

—

Published products in the store's listing order

How many of one thing this shopper may put in the box, ready for the box: {min, max, step, sold_individually, hint}

The variant a product card's Add button can post, or null when the card should link to the product instead

One product's curated block, for a theme rendering it somewhere the shipped partials do not

A product's releases, newest first, or the latest across the store: a changelog, a "what's new" strip or a ticker of what shipped lately

The sale covering one variant, or null at the ordinary price

The search route, {base}/search

The store's sectioned listing, resolved: the blocks catalog.sections declares, each already holding its products, for a theme that wants to draw them its own way rather than through the shipped partials

What a grouped product or a kit costs, in the visitor's currency

A sign-in link that brings the shopper back to a storefront page afterwards: this page when no page is named, or the one you name as a path under the shop ('/product/' ~ product.slug, '/cart') or as a whole kahunacart_url()

What a customer is told a status is

A product's stock, as a card, a stock line or a buy button draws it: {tracked, qty, sold_out, backorder, low, preorder, in_stock, digital, reason, label}

Whether the store is open, and whether this visitor may buy: the one thing a theme asks instead of reading the configuration

A stored region as the option value to preselect

One country's states or provinces, code => English name, for a <select>

Every subdivision list as JSON, once per response

Every tag in the store, each with its label, its slug, how many published products wear it, and the listing URL that filters on it

The small line under a price that says whether it includes tax ("incl. VAT", "excl. VAT"), or empty when the store is not asked to say so or charges no tax

A storefront URL, ready for an href or a form action

Whether the store prints whole amounts without their cents (storefront.whole_amounts)

A storefront extension zone, rendered: every widget an add-on mounted there, in the merchant's order, inside one element naming the zone

The signup form for a list, as HTML a theme can print anywhere

The booking picker for a product, by its slug, anywhere in a template. with pins it to one bookable

The page a customer's booking link opens, where they can see, move or cancel their own booking. The token is read from the address, never written into the page

Which products are free on which days, for a week-at-a-glance board

Openings left today, resources free right now and a class's places

One day, lane by lane: each person and each tub with what is booked on it, what is free and what is shut

The lengths a product is sold in, each with its price and start times

The next day from tomorrow with something free, or null

The appointments a shopper can book, flat or grouped by category

The sizes of a product and how many of each are free on a day

The people who do the work, each with a link that books them

The same list as data

A property's availability calendar, by its product slug. months is how many it draws, 1 to 12

The house rules and the next night to arrive on, or null on anything wrong

The rate bands still to come, in date order