home for the unassigned storefront context and an affiliate username for an attributed context.
In the patterns below, :credit means either home or an affiliate username.
Core paths
The cart is always
/cart. Do not prefix it with an affiliate credit.
Catalog and content paths
Use the listed routes for new theme links. Prefer the plural resource routes for attributed catalog
and content links. Use
/home/blog/:slug as the canonical unattributed post URL.
Personal site paths
Use/my/:credit for an affiliate’s personal site:
/:credit/... can use affiliate hydration to remain cacheable.
Build links in Liquid
Use the active credit when you build an attributed link:{{ username }} resolves to the home context after hydration.
Do not put the credit on the cart link:
Test route coverage
Before publishing a theme:- Open each page type with
/home/.... - Open the same page with a real affiliate username.
- Confirm navigation uses the preferred path for that page type.
- Confirm cart links use
/cart. - Test missing slugs and identifiers so your theme has a useful not-found state.
- Check links generated by navigation, cards, forms, and structured data.