Session tokens are issued by the store admin, and the launch URL of an embedded app has the store admin in host.
Changelog
The latest improvements to the YouCan ecosystem.
You log in with youcan auth login, your YouCan account and a login code.
You can exchange a session token for an online or an offline store token.
You can embed YouTube and Vimeo videos with filters, and read the theme editor state from JavaScript.
You can check a theme from the CLI with youcan theme check, loop over a range in tablerow, and paginate any array.
You can read a builder page as an outline of its sections.
You can choose the templates and section groups where an app block is available.
You can register any HTTPS redirect URI through dynamic client registration on the MCP server.
You can run your scripts again when a section is rendered again in the theme editor.
A change from a monthly plan to a yearly plan is now applied at once.
You get a code for the store state in API errors for a closed, on hold or deleted store.
You can preload fonts with preload_tag, and you can pass nil or a property to compact and uniq.
You can now reference Liquid objects in section and block setting values.
You can now list countries and read the visitor's country from the localization object.
You can now use more filters for colors, arrays, strings, prices, dates and pagination.
Variables that you create in a snippet rendered with render are now kept inside the snippet.
Use at most 2 decimals in the price.amount of a charge.
Cancel a recurring charge at once and credit the store for the unused days.
If a charge return_url is outside your app URL, the merchant is redirected to it with no parameters added.
You can link sellers from your app to the theme editor to add an app block or open an app embed.
A store gets one free trial per app.
You can now write blocks as Liquid files in the blocks directory, use them in many sections, and nest them.
New endpoints read and change the customization of the classic theme. The MCP server has a tool for each.
GET /me returns the account email of the store owner in email. The store contact email moves to store_email.
You can define a palette of named colors for the color and color_background settings of a theme.
You can define color schemes that sellers edit in the theme editor, and sellers can pick a scheme for each section.
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.
You can resize images with image_url, get a srcset from image_tag, inline SVG icons, and print prices with the currency code.
You can choose the templates where a section is available, and add CSS with the stylesheet tag.
You can put sections in a section group, and sellers can edit the group in the theme editor.
Themes can use the product_list and collection_list setting types to let sellers pick several products or collections.
Sellers can switch between the presets of settings_data.json in the theme editor. Each preset is a theme style.
The t filter supports interpolation and plural forms, and falls back to the default locale file. Schema translations accept keys with hyphens.
A collection setting can be set to all products.
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 saves and uploads report deprecated names and common Liquid mistakes as warnings. Settings are checked against their type.
Themes can show placeholder illustrations with the placeholder_svg_tag filter.
with, for and as now work on render, include renders snippets, and the older paginate form now sets the paginate object.
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.
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.
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.
for loops take an else block, the sum filter adds numbers, and json prints numbers, booleans and nil as JSON values.
You can get one or more sections of a storefront page without the rest of the page, with section_id and sections.
The form tag covers the cart, coupons, reviews and express checkout, and every form works without JavaScript. The search page has a search object.
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.
first and last work inside a path, {% dump %} and json print the values of objects, and a missing metafield is nil.
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.
Themes can use the text_alignment, inline_richtext and link_list setting types, and link lists have a handle.
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.
Only apps can create, update or delete metafields, and only in the namespace equal to their app handle.
New endpoints and a REST hook event expose a store's abandoned carts.
POST /products/update/{id} now updates only the fields you send. name, price and has_variants are no longer required.
The YouCan MCP server connects AI assistants such as Claude, ChatGPT, Cursor and VS Code to a store, at https://mcp.youcan.shop.
New endpoints list and upload images in the store image library. POST /media/{source}/upload-image is deprecated.
New endpoints read, create, update and preview page builder pages. The MCP server has a tool for each.
We are happy to introduce our global changelog, a single place for all the updates and improvements we made to the YouCan ecosystem.