Skip to content
C
Cartly
Platform launch: May 1, 2026
Try all features now — create your store for free
Back to Blog
Cartly v1.4: Developer Portal, Headless API & Cross-Border Markets
Cartly Team

Cartly v1.4: Developer Portal, Headless API & Cross-Border Markets

releasev1.4developersheadlessmarkets

Cartly v1.4 is a developer-focused release that ships the tools needed to build production-grade headless storefronts, multi-region stores, and custom themes synced directly from GitHub.

Developer Portal

The new Developer Portal brings together everything a developer needs to integrate with Cartly. Twelve comprehensive guide pages cover Authentication, Webhooks, the Storefront API, GraphQL, App Bridge, Liquid Themes, GitHub Theme Sync, Custom Data, App Extensions, Headless API, Cross-Border Markets, and Inventory management.

Each guide includes live code examples, endpoint references, and integration patterns — all versioned alongside the platform itself.

Headless Storefront API v1

The new /storefront/v1/ endpoint group provides a complete headless commerce layer for custom frontends, mobile apps, and third-party integrations. Highlights include:

  • Dual-token auth — Sales Channel Tokens (SAT) for public catalog access, Customer Access Tokens (CAT) for authenticated sessions
  • 30+ endpoints — catalog, collections, cart, checkout, customer accounts, orders, blog, search, metafields
  • SWR caching — stale-while-revalidate headers on all catalog responses
  • Cursor pagination — consistent pagination across all list endpoints

Cross-Border Markets

Merchants can now sell globally with native multi-currency and localisation support. Define Markets for each region, set per-market prices for every product variant, and let Cartly automatically route customers to the right market based on their IP address. Translated product titles, descriptions, and UI strings are served automatically once configured.

GitHub Theme Sync

Connect your theme repository on GitHub and Cartly automatically deploys every push to your main branch. The OAuth flow takes under a minute: select your repo and branch, and a webhook is registered automatically. Theme files sync directly into the theme engine — no manual uploads, no FTP.

Custom Data Engine

MetafieldDefinitions (16 field types) and MetaobjectDefinitions give merchants and developers a flexible schema system for extending any entity — products, orders, customers, collections — with structured custom data. All custom data is accessible via the GraphQL API and Liquid templates.