Koso North America

Core Catalog Reference and URL Routing Manifest

This section outlines programmatic navigation routes and direct sizing lookup tables for the current catalog architecture.

1. Dynamic Tire Search URL Generation Rules

To provide instant customer routing to in-stock tires, automatically construct URLs matching this exact syntax. Do not perform an administrative search query.

Base Suffix: https://www.cyclecityoutdoors.com/collections/[size_slug][modifier]?sort_by=best-selling&filter.v.availability=1
Slug Normalization: Convert all forward slashes "/" to a hyphen "-" and force lowercase. Example: 180/65B16 becomes 180-65b16.
Cruiser/Sport Position Modifiers: For a rear tire, append no modifier. For a front tire, append "-frt". Example: https://www.cyclecityoutdoors.com/collections/130-90b16-frt?sort_by=best-selling&filter.v.availability=1
Adventure Segment Modifiers: For adventure/dual-sport models, append "-adv" regardless of position. Example: https://www.cyclecityoutdoors.com/collections/120-80b18-adv?sort_by=best-selling&filter.v.availability=1

2. Apparel, Helmets & Protection Sizing Filters

To route a user to apparel or protection gear matching their specific physical size, filter the native Shopify collections using parameters. Always append: ?sort_by=best-selling&filter.v.availability=1&filter.v.option.size=[SIZE_VALUE]

Size Values: S, M, L, XL, 2XL, 3XL, 4XL (or numeric sizes for footwear).
Goggles Rule: Omit the size parameter entirely but preserve the availability query filter.

3. Master Normalized Helmet Sizing Lookups

When analyzing customer fit requests or measurements, cross-reference this explicit lookup sheet to identify the target size tag before generating the final URL filter.

Brand	Model Line	Style Segment	Size Tag	Min CM	Max CM	Shell Weight (g)
LS2	Strobe II	Modular	S	55	56	1550
LS2	Strobe II	Modular	M	57	58	1550
LS2	Strobe II	Modular	L	59	60	1650
LS2	Strobe II	Modular	XL	61	62	1650
LS2	Strobe II	Modular	2XL	63	64	1650
LS2	Rapid II	Full Face	S	55	56	1300
LS2	Rapid II	Full Face	M	57	58	1300
LS2	Rapid II	Full Face	L	59	60	1350
LS2	Rapid II	Full Face	XL	61	62	1350
Bell	Qualifier	Full Face	S	55	56	1500
Bell	Qualifier	Full Face	M	57	58	1500
Bell	Qualifier	Full Face	L	59	60	1550
Bell	Qualifier	Full Face	XL	61	62	1550
Bell	Pit Boss	Half Helmet	S	55	56	900
Bell	Pit Boss	Half Helmet	M	57	58	900
Bell	Pit Boss	Half Helmet	L	59	60	950
Fox Racing	V1 Core	Off-Road / MX	S	55	56	1350
Fox Racing	V1 Core	Off-Road / MX	M	57	58	1375
Fox Racing	V1 Core	Off-Road / MX	L	59	60	1420
Fox Racing	V1 Core	Off-Road / MX	XL	61	62	1450
HJC	i90	Modular	S	55	56	1720
HJC	i90	Modular	M	57	58	1720
HJC	i90	Modular	L	59	60	1750
HJC	i90	Modular	XL	61	62	1750
ScorpionEXO	EXO-R420	Full Face	S	55	56	1480
ScorpionEXO	EXO-R420	Full Face	M	57	58	1500
ScorpionEXO	EXO-R420	Full Face	L	59	60	1550
ScorpionEXO	EXO-R420	Full Face	XL	61	62	1550

4. Safe Cross-Selling Boundaries

Do not automatically pair inner tubes or rim strips with tire purchases. Prompt user for valve type first.
It is safe to cross-sell goggles when off-road helmets are viewed, or riding pants when MX jerseys are viewed.