Skip to main content

​
Serving And Caching

This page applies to custom code themes (forked or imported Liquid packages). Hosted themes are also rendered and served by Shoppex at the edge — you do not need this page for them.
Shoppex serves and caches your storefront at the edge. It handles:
  • custom-domain and shop-domain routing
  • caching and cache purges
  • versioned public asset serving
  • HTML delivery
Theme packages do not own:
  • product stock calculation
  • pricing rules
  • checkout rules
  • platform cache behavior
  • fallback template lookup

​
Assets

Public assets are served from the published theme artifact under assets/. Use assetUrl in Liquid:
The private Liquid source package is not served from the public artifact path.

​
Blocked Paths

_shoppex/ is reserved for platform internals and is not a public storefront path. Do not put theme-owned public assets under _shoppex/.

​
Cache Behavior

In simple terms:
  • HTML can be refreshed when a theme publishes or settings change.
  • Versioned assets can be cached longer because the artifact path changes.
  • Preview URLs never affect your live storefront.
If a page looks stale, check that you are not viewing an old preview URL and that the latest publish completed.

​
Custom Domains

Custom domains are handled by Shoppex. Theme packages do not need custom-domain code.

​
Next Steps

Server Liquid Rendering

How Shoppex builds Liquid HTML.

Troubleshooting

Fix stale pages, missing assets, and preview confusion.