Skip to content

Changelog ​

View as Markdown

The latest improvements to the YouCan ecosystem.

CLI login with a code

You log in with youcan auth login, your YouCan account and a login code.

Theme check and Liquid fixes

You can check a theme from the CLI with youcan theme check, loop over a range in tablerow, and paginate any array.

App block availability

You can choose the templates and section groups where an app block is available.

MCP client registration

You can register any HTTPS redirect URI through dynamic client registration on the MCP server.

Theme editor events

You can run your scripts again when a section is rendered again in the theme editor.

Plan change timing

A change from a monthly plan to a yearly plan is now applied at once.

Store state errors

You get a code for the store state in API errors for a closed, on hold or deleted store.

Array and preload filters

You can preload fonts with preload_tag, and you can pass nil or a property to compact and uniq.

Countries in localization

You can now list countries and read the visitor's country from the localization object.

Charge return URL

If a charge return_url is outside your app URL, the merchant is redirected to it with no parameters added.

Theme editor links for apps

You can link sellers from your app to the theme editor to add an app block or open an app embed.

Theme blocks

You can now write blocks as Liquid files in the blocks directory, use them in many sections, and nest them.

Classic theme endpoints

New endpoints read and change the customization of the classic theme. The MCP server has a tool for each.

Store owner account details

GET /me returns the account email of the store owner in email. The store contact email moves to store_email.

Color palette

You can define a palette of named colors for the color and color_background settings of a theme.

Color schemes

You can define color schemes that sellers edit in the theme editor, and sellers can pick a scheme for each section.

Font picker setting

Themes can let sellers pick any Google font or a system font with the font_picker setting type, and load it with the new font filters.

Image, asset and currency filters

You can resize images with image_url, get a srcset from image_tag, inline SVG icons, and print prices with the currency code.

Section groups

You can put sections in a section group, and sellers can edit the group in the theme editor.

Theme styles

Sellers can switch between the presets of settings_data.json in the theme editor. Each preset is a theme style.

Theme translations

The t filter supports interpolation and plural forms, and falls back to the default locale file. Schema translations accept keys with hyphens.

Liquid visible_if conditions

visible_if accepts a Liquid string. A theme with a Liquid condition can be imported, and the setting is always shown in the theme editor.

Theme warnings and setting checks

Theme saves and uploads report deprecated names and common Liquid mistakes as warnings. Settings are checked against their type.

Theme file checks and required files

Every theme file is checked when it is saved. If a save is rejected, you get the list of errors with their file and line. Themes must contain a layout and nine templates. The doc tag is supported.

Customer accounts

Themes can render the customer account pages: login, register, password reset, account, orders and addresses. A customer object describes the logged in customer, and the storefront API has customer endpoints for login, logout and password recovery.

Inline Liquid errors

When a Liquid error occurs, only the failed part of the page is replaced with the error, its file and its line. In the code editor, syntax errors are marked on their line.

Liquid loops and filters

for loops take an else block, the sum filter adds numbers, and json prints numbers, booleans and nil as JSON values.

Section rendering

You can get one or more sections of a storefront page without the rest of the page, with section_id and sections.

Storefront forms and search

The form tag covers the cart, coupons, reviews and express checkout, and every form works without JavaScript. The search page has a search object.

Collection and product listings

Themes can list products and collections without a setting for each one: collections, collection.products, all_products, and a paginate tag for any of these lists.

Liquid object values

first and last work inside a path, {% dump %} and json print the values of objects, and a missing metafield is nil.

Theme schema names and JSON comments

Section schemas, blocks, presets and settings groups take a name, the category setting is now collection, and the layout folder is layout/. JSON theme files accept comments and trailing commas.

New theme setting types

Themes can use the text_alignment, inline_richtext and link_list setting types, and link lists have a handle.

Theme info and Liquid tag fixes

settings_schema.json can declare the theme's name, author, version and support links in a theme_info entry. The liquid, echo and dump tags are fixed, and theme files are checked on save.

Metafield write rules

Only apps can create, update or delete metafields, and only in the namespace equal to their app handle.

Abandoned carts

New endpoints and a REST hook event expose a store's abandoned carts.

Partial product updates

POST /products/update/{id} now updates only the fields you send. name, price and has_variants are no longer required.

MCP server

The YouCan MCP server connects AI assistants such as Claude, ChatGPT, Cursor and VS Code to a store, at https://mcp.youcan.shop.

Store image library endpoints

New endpoints list and upload images in the store image library. POST /media/{source}/upload-image is deprecated.

Page builder endpoints

New endpoints read, create, update and preview page builder pages. The MCP server has a tool for each.

We now have a global changelog!

We are happy to introduce our global changelog, a single place for all the updates and improvements we made to the YouCan ecosystem.