Skip to main content
Fluid storefront pages use a credit segment to carry affiliate attribution. Use 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:
Personal-site templates receive affiliate-specific values directly. Storefront templates on /: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. Replace acme 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. Use the active credit when you build an attributed link:
For anonymous visitors, {{ username }} resolves to the home context after hydration. Do not put the credit on the cart link:

​
Test route coverage

Before publishing a theme:
  1. Open each page type with /home/....
  2. Open the same page with a real affiliate username.
  3. Confirm navigation uses the preferred path for that page type.
  4. Confirm cart links use /cart.
  5. Test missing slugs and identifiers so your theme has a useful not-found state.
  6. Check links generated by navigation, cards, forms, and structured data.