Liquid filters

Filters transform values: {{ product.price | money }}. Click any filter for syntax, parameters, and example output.

Filters come from two sources. The Standard filters at the bottom of this page are the liquidjs built-ins (abs, append, map, where, and so on) — the same general-purpose, Shopify-compatible surface you would find in any Liquid theme. Everything above them — money, image, color, font, URL, commerce, and the platform-specific string and data filters — is registered by Sellerlane and tuned for an Indian storefront: prices are stored in paise, money formats follow the store currency, and the metafield and recommendation filters read live store data.

A handful of filters listed below ship in the theme engine but do not yet have their own reference page. Their names and behaviour are documented inline in the relevant section.

Money

Money filters take an integer price in paise and render it in the store currency (₹ for INR storefronts), so 199900 | money becomes ₹1,999.00. For how prices, GST, and tax-inclusive display are calculated, see Taxes.

Filter	Description
money	Formats a price (stored in paise) using the store currency.
money_with_currency	Formats a price and appends the ISO currency code.
money_without_currency	Formats the amount without a currency symbol.
money_without_trailing_zeros	Formats a price, dropping “.00” when whole.
money_amount	Returns the decimal amount as a number, for arithmetic.
weight_with_unit	Formats a variant weight with its unit (e.g. 500 g); accepts an optional unit override.
unit_price_with_measurement	Renders a price-per-unit string such as ₹50.00/100 ml from a price and a measurement object.

Images & media

Image and media filters resize and optimize from the CDN on the fly and render the right markup for each media type — <img>, an adaptive-streaming video player, an external-video embed, or an interactive 3D/AR viewer. For where these assets live, see Files; to upload 3D models, see Digital products.

Filter	Description
image_url	Returns a CDN URL for an image, resized and optimized on the fly. Requires width or height.
image_tag	Renders a complete <img> element (srcset, sizes, alt, lazy-loading) from an image URL.
media_tag	Renders any media object: image, adaptive-streaming video player, or interactive 3D/AR viewer.
video_tag	Renders a <video> element with HLS and MP4 sources for a video media object.
external_video_tag	Renders an <iframe> embed for an external (YouTube/Vimeo) video media object or URL.
external_video_url	Returns the embeddable URL for an external video media object.
model_viewer_tag	Renders the interactive <model-viewer> element (GLB source) for a 3D model media object.
placeholder_svg_tag	Renders a named placeholder SVG (e.g. product-1) for empty image slots.
asset_img_url	Image URL for a file in the theme’s assets/ folder, at a named size.
file_img_url	Image URL for an admin-uploaded file, at a named size.
preload_tag	Emits <link rel="preload"> for a resource URL — use on the LCP hero image.
payment_type_img_url	URL of the icon for a payment type.
payment_type_svg_tag	Inline SVG tag for a payment type icon.

Colors

Filter	Description
color_to_rgb	Converts a color to rgb()/rgba() notation.
color_to_hsl	Converts a color to hsl()/hsla() notation.
color_to_hex	Converts a color to 6-digit hex.
color_to_oklch	Converts a color to oklch() notation (modern CSS color space).
color_lighten	Lightens a color by a percentage.
color_darken	Darkens a color by a percentage.
color_saturate	Increases saturation by a percentage.
color_desaturate	Decreases saturation by a percentage.
color_mix	Mixes two colors by weight.
color_modify	Sets one channel of a color (red, green, blue, alpha, hue, saturation, lightness).
color_extract	Reads one channel of a color.
color_brightness	Perceived brightness (0–255) — use to choose readable text color.
color_contrast	WCAG contrast ratio between two colors.
color_difference	Color difference between two colors (0–765).
brightness_difference	Brightness difference between two colors (0–255).

Fonts

Filter	Description
font_face	Emits the @font-face CSS for a font setting.
font_family	The CSS font-family stack for a font, including fallbacks.
font_url	CDN URL of the font file (woff2 by default).
font_modify	Returns a related font variant by property — e.g. font_modify: 'weight', 'bold'.
font_stylesheet_url	URL of a stylesheet covering the given fonts.
font_stylesheet_tag	Complete <link rel="stylesheet"> tag for the given fonts.

Note

font_modify is registered in the theme engine but does not yet have its own reference page. It takes a font, a property (style or weight), and a target value, and returns the matching variant in the same family — for example {{ settings.body_font | font_modify: 'weight', 'bold' }}.

URLs & links

Filter	Description
asset_url	Versioned CDN URL for a file in the theme’s assets/ folder.
global_asset_url	URL for a platform-provided shared asset.
shopify_asset_url	Compatibility alias for platform asset URLs (eases Shopify theme ports).
file_url	Public URL for a file uploaded in the admin (Files).
stylesheet_tag	Renders a <link rel="stylesheet"> for a URL.
script_tag	Renders a <script src> tag for a URL.
inline_asset_content	Inlines a theme asset’s raw contents into the page (ideal for SVG icons).
link_to	Builds an <a> tag.
link_to_tag	Link that filters the current collection to one tag.
link_to_add_tag	Link that adds a tag to the active collection filters.
link_to_remove_tag	Link that removes a tag from the active collection filters.
link_to_type	Link to the automatic collection for a product type.
link_to_vendor	Link to the automatic collection for a vendor.
url_for_type	URL of the automatic collection for a product type.
url_for_vendor	URL of the automatic collection for a vendor.
highlight_active_tag	Wraps the tag in a highlight class when it is an active filter.
customer_login_link	Login link for the customer account area.
customer_logout_link	Logout link for the signed-in customer.
customer_register_link	Registration link for new customer accounts.
login_button	Renders the platform login button.
url_escape	Percent-encodes unsafe URL characters.
url_param_escape	Percent-encodes a value for use as a query parameter (also encodes &).
encode_url_component	JavaScript-style encodeURIComponent.

Strings & data

Filter	Description
t	Translates a key from the theme’s locales/ files. Supports interpolation and counts.
translate	Alias of t.
json	Serializes any value or object to JSON.
api_json	Serializes drops into the storefront-API JSON shape — for passing data to JavaScript.
structured_data	JSON-LD structured data (Product, Article…) for rich search results.
metafield_text	Renders a metafield’s value as plain text, resolving its type (pass field: for a sub-field).
metafield_tag	Renders a metafield’s value as type-aware HTML (rich text, list, image, money, and so on).
format_address	Locale-aware HTML for a postal address.
date	Formats a date with strftime patterns or named formats; locale-aware.
time_tag	Semantic <time datetime> element with formatted text.
pluralize	Chooses singular or plural based on a count.
camelize	Converts a string to CamelCase.
highlight	Wraps occurrences of the search terms in <strong class="highlight">.
base64_url_safe_encode	URL-safe Base64 encode.
base64_url_safe_decode	URL-safe Base64 decode.
blake3	BLAKE3 hash of a string (hex).
default	Fallback when a value is nil, false, or empty.
default_pagination	Renders prev/next page controls for a paginate block.
sort_by	Appends a sort_by parameter to a collection URL.
within	Scopes a product URL to a collection for collection-aware navigation.

Tip

metafield_text and metafield_tag are the recommended way to render custom data without escaping or type-handling it yourself. They are registered in the theme engine but do not yet have their own reference pages. For how metafields are defined and bound, see Metafields and Dynamic sources.

Commerce

Filter	Description
product_inventory_json	Per-variant live inventory payload used by themes for client-side availability.
payment_button	Renders the dynamic checkout button for the current product form.
payment_terms	Renders payment terms/installments messaging when available.
avatar	Avatar element (initials) for a customer.
recommendations_for_product	Live product recommendations for a given product/variant (and optional cart context).
recommendations_for_cart	Live “complete the look” recommendations for the current cart.
recommendations_for_cart_drawer	Recommendations sized and styled for the cart drawer.
recommendations_generic	Store-wide recommendations with no specific product or cart anchor.
item_count_for_variant	Total quantity of a given variant currently in the cart.
line_items_for	The cart line items matching a given product or variant.
editor_setting	Theme-editor binding attribute so a setting becomes click-to-edit in the visual editor. No output on the live store.

Note

The recommendations_* filters and the cart helpers item_count_for_variant and line_items_for are registered in the theme engine but do not yet have their own reference pages. The recommendation filters return a drop you can loop over; they read live catalog and inventory data. For how recommendations are generated, see Search and discovery and the Product recommendations API.

Standard

These are the liquidjs built-in filters — the general-purpose, Shopify-compatible surface available in every theme. They do not touch store data; they transform strings, numbers, and arrays.

Filter	Description
abs	Absolute value.
append	Appends a string.
at_least	Clamps a number to a minimum.
at_most	Clamps a number to a maximum.
capitalize	Uppercases the first character.
ceil	Rounds up.
compact	Removes nil values from an array.
concat	Concatenates two arrays.
divided_by	Division.
downcase	Lowercases a string.
escape	HTML-escapes a string.
escape_once	HTML-escapes without double-escaping entities.
first	First element of an array.
floor	Rounds down.
join	Joins array elements with a separator.
last	Last element of an array.
lstrip	Strips leading whitespace.
map	Plucks a property from each element.
minus	Subtraction.
modulo	Remainder.
newline_to_br	Converts newlines to <br>.
plus	Addition.
prepend	Prepends a string.
remove	Removes every occurrence of a substring.
remove_first	Removes the first occurrence of a substring.
replace	Replaces every occurrence.
replace_first	Replaces the first occurrence.
reverse	Reverses an array.
round	Rounds to the nearest integer or given decimals.
rstrip	Strips trailing whitespace.
size	Length of a string or array.
slice	Substring/sub-array by offset and length.
sort	Sorts an array (case-sensitive); pass a property to sort objects.
sort_natural	Case-insensitive sort.
split	Splits a string into an array.
strip	Strips surrounding whitespace.
strip_html	Removes HTML tags.
strip_newlines	Removes newline characters.
sum	Sums array values; pass a property name for objects.
times	Multiplication.
truncate	Truncates to a length with an ellipsis.
truncatewords	Truncates to a word count.
uniq	Removes duplicates.
upcase	Uppercases a string.
url_decode	Decodes percent-encoding.
url_encode	Percent-encodes for URLs (spaces become +).
where	Filters an array of objects by property value.

Next steps

• Liquid objects — the data these filters operate on.
• Liquid tags — control flow, loops, and rendering.
• Dynamic sources — bind metafields and resource data into settings.
• Theme assets, CSS & JS — how asset and stylesheet filters fit the build.