home for the unassigned storefront context and an affiliate username for an attributed context.
A path with an affiliate username establishes that affiliate’s credit. A path without one, such as a home path, establishes no new credit and doesn’t remove credit the visitor already has. See How credit is established and kept.
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.
A resource’s canonical_url is its path with home as the credit segment, such as /home/pages/:slug for a page. See Canonical URLs.
An unknown username in the credit segment doesn’t return an error: the page renders as it would for home, and establishes no new credit. Share links (/s/:token) redirect to the credited page for the shared resource.
Custom and non-credited routes
A company can add its own routes. A credited custom route serves at/:credit/<path>, like the pages above. A non-credited route serves only at /<path>, establishes no credit, and returns 404 at /:credit/<path>. Redirects can also send a path elsewhere. See Custom routes before you link to one.
Platform paths
Fluid serves these on every storefront domain. Don’t build theme pages at them.
See Sitemap for what the sitemap lists.
Personal site paths
Use/my/:credit for an affiliate’s personal site:
/:credit/... can use affiliate hydration to remain cacheable.
Member paths
Member pages are served on your company’s account subdomain, not on the storefront domain. Replaceacme with your company’s Fluid subdomain.
Member paths carry no credit segment. On the storefront domain, the
/accounts prefix is reserved and serves no pages, so do not link to it. Inside a member layout, read link targets from settings.menu and member_routes rather than building them by hand. See member sites.
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.