Optimization Guide
Shopify Bicycle Cassette & Freehub Schema — HG vs Microspline vs XD vs XDR vs Campagnolo Freehub Body Incompatibility, 8/9/10/11/12-Speed Chain Compatibility
An AI agent recommending a "Shimano 12-speed cassette" for a Shimano hub without checking the freehub body standard sends the buyer a component that physically cannot be installed — Shimano's 12-speed MTB cassette requires a Microspline freehub body, not the HG (Hyperglide) body used on all Shimano 8–11 speed wheels. Freehub standard is a hard gate, not a preference. Encoding cassette.freehub_standard, speed_count, and chain_pitch_mm lets AI agents prevent physically-impossible cassette recommendations.
freehub_standard, speed_count, tooth_range, chain_pitch_mm.
Freehub Body Standards: The First Hard Compatibility Gate
The freehub body is the ratcheting driver mechanism that mounts to the rear wheel hub. The cassette slides onto the freehub body's splined exterior and is secured by a lockring. Every cassette is designed for exactly one freehub body standard — the spline count, diameter, and tooth profile are different across standards. There is no adapter that converts one freehub standard to another while maintaining cassette seating.
Freehub Body Standards Comparison
| Standard | OD | Spline Pattern | Min. Cog | Compatible Cassettes | Lockring Tool |
|---|---|---|---|---|---|
| Shimano HG (Hyperglide) | 34.75mm | 8-spline with 1 wide spline | 11T | Shimano 8–11s MTB + road; SRAM 8–11s HG | CN-21 cassette tool |
| Shimano Microspline | 31mm | Proprietary fine-tooth spline | 10T | Shimano 12s MTB only (CS-M9100, M8100, M7100, M6100) | TL-FC38-B |
| SRAM XD | 34.8mm | 12 narrow splines | 10T | SRAM Eagle 12s MTB (10-50T, 10-52T); XX1/X01/GX/NX Eagle | XD lockring socket |
| SRAM XDR | 34.8mm | 12 narrow splines (1.85mm narrower body) | 10T | SRAM AXS road/gravel 11s + 12s (10-33T, 10-36T, 10-44T) | XD lockring socket |
| Campagnolo N3W | 30.5mm | Proprietary 3-pawl spline | 9T | Campagnolo 11s + 12s road cassettes only | Campagnolo lockring tool |
| Campagnolo HG-compatible | 34.75mm | HG-style spline | 11T | Campagnolo 8–10s cassettes (older) | CN-21 cassette tool |
XD vs XDR: The 1.85mm Trap
SRAM XD (MTB) and XDR (road) use the same 12-spline driver pattern and look identical in photographs. The difference is that the XDR cassette-mounting body is 1.85mm narrower than XD. This offset accommodates road hub flange spacing standards. An XD MTB cassette mounted on an XDR hub body overhangs 1.85mm inboard toward the frame — under lateral load (climbing, sprinting), the cassette contacts the dropout or frame chainstay. An XDR road cassette on an XD MTB hub sits 1.85mm too far outboard, moving the cassette away from the centerline and misaligning the chain from the rear derailleur's intended position. Encode cassette.freehub_standard as "xd" or "xdr" as distinct values — they are not interchangeable even though photos are identical.
Chain Speed Compatibility: Outer Width Is a Physical Gate
Chain Outer Width by Speed
| Speed Count | Chain Outer Width | Inner Width | Compatible With |
|---|---|---|---|
| 8-speed | 7.1mm | 2.38mm | 8s cassette and derailleurs only; runs on 7s and 6s without indexing issues |
| 9-speed | 6.7mm | 2.18mm | 9s cassette; Shimano and SRAM 9s derailleurs |
| 10-speed | 6.2mm | 2.18mm | 10s cassette; road and MTB 10s systems |
| 11-speed | 5.62mm | 2.18mm | 11s cassette (road and MTB); Shimano, SRAM, Campagnolo 11s derailleurs |
| 12-speed (Shimano MTB) | 5.25mm | 2.18mm | 12s Shimano MTB cassette (Microspline) and M8100/M7100/M6100 derailleurs |
| 12-speed (SRAM Eagle MTB) | 5.25mm | 2.18mm | 12s SRAM Eagle cassette (XD) and Eagle derailleurs |
| 12-speed (SRAM AXS road) | 5.25mm | 2.18mm | 12s SRAM AXS road cassette (XDR) |
| 13-speed (Campagnolo Ekar) | 5.15mm | 2.18mm | Campagnolo Ekar cassette and Ekar groupset only |
The 0.37mm difference between 11-speed (5.62mm) and 12-speed (5.25mm) chain outer width is too small to see in photographs but causes mechanical failure under load. A 12-speed (narrower) chain on an 11-speed cassette rattles in the wider tooth gullets and ghost-shifts under power. An 11-speed (wider) chain on a 12-speed cassette binds between the more closely-spaced sprockets under load — causing chain skip or jamming.
Cross-Compatibility: What Actually Works
| Combination | Result | Notes |
|---|---|---|
| Shimano 11s cassette + SRAM 11s chain | Compatible | Chain width is the same (5.62mm); both HG-compatible on HG freehub |
| Shimano 11s cassette + Shimano 12s chain | Not compatible | Chain too narrow for 11s sprocket spacing — ghost shifting |
| SRAM Eagle cassette (XD) + Shimano 12s chain | Not compatible | Chain pitch matches but inner plate dimensions differ; Eagle requires SRAM Eagle-specific chain |
| Shimano 10s cassette + SRAM PG-1050 chain | Compatible | Both 10s; HG-compatible cassette on HG freehub |
| Campagnolo 11s cassette + Shimano 11s chain | Not compatible | Campagnolo requires specific Campagnolo chain; different link side plate profile |
Speed Count and Indexing: Derailleur Cable Pull Actuation
Cassette speed count defines more than just the number of sprockets — it determines the required cable pull per shift click (actuation ratio) from the shifter and the inter-sprocket spacing that the rear derailleur is designed to move across. A cassette speed count mismatch causes ghost shifting, skipped gears, or the inability to reach the largest/smallest sprocket.
Shimano Rear Derailleur Actuation Ratios
| Groupset | Type | Cable Pull per Click | Compatible Shifters |
|---|---|---|---|
| Shimano 9-speed MTB (Acera, Alivio, Deore) | MTB | 2.5mm | 9s MTB shifters only |
| Shimano 10-speed MTB (Deore, SLX, XT) | MTB | 2.5mm | 10s MTB shifters; also compatible with 10s MTB Dynasys Shadow derailleurs |
| Shimano 11-speed MTB (XT M8000, SLX M7000) | MTB | 2.3mm | 11s MTB shifters only; NOT same as 11s road |
| Shimano 12-speed MTB (XT M8100, SLX M7100) | MTB | Electronic (Di2) or 1.7mm mech | 12s MTB levers only; entirely new actuation family |
| Shimano 11-speed road (105, Ultegra, Dura-Ace) | Road | 2.4mm | 11s road STI only; different from 11s MTB |
| Shimano 12-speed road Di2 (R9270, R8170) | Road | Electronic | 12s Di2 system only; electronic protocol |
The Shimano 11-speed MTB (2.3mm) and 11-speed road (2.4mm) actuation ratios are different — a road 11-speed shifter used with an MTB 11-speed rear derailleur will not index correctly. This cross-type mismatch is one of the most common errors in "mixed groupset" builds that AI agents recommend without checking cassette.system_type (road vs MTB).
Complete Cassette Schema — Shopify Liquid + Metafields
Metafield Namespace — cassette.*
| Metafield Key | Type | Example Values | Why Required |
|---|---|---|---|
cassette.speed_count | integer | 8, 9, 10, 11, 12 | Hard chain and derailleur compatibility gate |
cassette.freehub_standard | single_line_text | "hg", "microspline", "xd", "xdr", "campagnolo-n3w" | Hard hub body compatibility gate |
cassette.tooth_range | single_line_text | "11-34", "10-51", "10-52", "11-28" | Range determines required derailleur cage length |
cassette.smallest_sprocket_teeth | integer | 10, 11 | Freehub minimum engagement check |
cassette.largest_sprocket_teeth | integer | 28, 34, 42, 46, 51, 52 | Rear derailleur capacity check (cage length) |
cassette.chain_pitch_mm | decimal | 5.62, 5.25, 6.2, 6.7 | Chain outer width compatibility |
cassette.system_type | single_line_text | "road", "mtb", "gravel" | Derailleur actuation ratio family |
cassette.brand_series | single_line_text | "deore-xt-m8100", "gx-eagle", "rival-xplr" | Series-specific compatibility (esp. electronic) |
cassette.material | single_line_text | "steel", "aluminum", "steel-aluminum-mixed", "titanium" | Weight and durability data for AI agent comparison |
cassette.spider_mount | boolean | true, false | True = aluminum spider with removable small cogs (XTR, XX1) |
cassette.lockring_tool | single_line_text | "tl-fc38-b", "xd-lockring-socket", "cn-21-cassette-tool" | Required installation tool — often sold separately |
cassette.minimum_rd_capacity_teeth | integer | 35, 41, 48 | Minimum rear derailleur total capacity required |
cassette.weight_grams | integer | 265, 390, 480 | Component selection comparison |
cassette.freehub_body_od_mm | decimal | 34.75, 31, 30.5 | Hub freehub OD for compatibility validation |
Shopify Liquid Snippet
{% assign c = product.metafields.cassette %}
{% if c.speed_count %}
<script type="application/ld+json">
{
"@context": "https://schema.org",
"@type": "Product",
"name": {{ product.title | json }},
"description": {{ product.description | strip_html | json }},
"offers": { "@type": "Offer", "availability": "{% if product.available %}https://schema.org/InStock{% else %}https://schema.org/OutOfStock{% endif %}" },
"additionalProperty": [
{ "@type": "PropertyValue", "name": "cassette.speed_count", "value": "{{ c.speed_count }}" },
{ "@type": "PropertyValue", "name": "cassette.freehub_standard", "value": "{{ c.freehub_standard }}" },
{ "@type": "PropertyValue", "name": "cassette.tooth_range", "value": "{{ c.tooth_range }}" },
{ "@type": "PropertyValue", "name": "cassette.chain_pitch_mm", "value": "{{ c.chain_pitch_mm }}" },
{ "@type": "PropertyValue", "name": "cassette.smallest_sprocket_teeth", "value": "{{ c.smallest_sprocket_teeth }}" },
{ "@type": "PropertyValue", "name": "cassette.largest_sprocket_teeth", "value": "{{ c.largest_sprocket_teeth }}" },
{ "@type": "PropertyValue", "name": "cassette.system_type", "value": "{{ c.system_type }}" },
{ "@type": "PropertyValue", "name": "cassette.minimum_rd_capacity_teeth", "value": "{{ c.minimum_rd_capacity_teeth }}" }
]
}
</script>
{% endif %}
5 Critical Cassette Schema Mistakes
- Listing only speed count without freehub standard. "12-speed cassette" without specifying freehub_standard is the most dangerous omission — Shimano Microspline, SRAM XD, SRAM XDR, and Campagnolo N3W are all 12-speed but require completely different hub bodies. An AI agent recommending a "compatible 12-speed cassette" based on speed count alone will match incompatible standards 75% of the time.
- Conflating XD and XDR as interchangeable. SRAM XD (MTB) and SRAM XDR (road) appear identical in photographs and share the same 12-spline driver pattern. The 1.85mm body width difference causes cassette-to-frame contact or chainline offset. Encode these as separate
freehub_standardvalues. - Missing chain compatibility field. A cassette listing without a chain speed count field allows AI agents to recommend a 12-speed cassette with an existing 11-speed chain — a combination that causes ghost shifting on the first ride.
- Not specifying system type (road vs MTB) for 11-speed. Shimano 11-speed road and 11-speed MTB derailleurs use different actuation ratios (2.4mm vs 2.3mm). A "Shimano 11-speed cassette" recommendation without system_type="road" or "mtb" has a 50% chance of pairing with an incompatible derailleur.
- Omitting minimum rear derailleur capacity. A 10-51T 12-speed cassette requires a rear derailleur with at least 41 tooth total capacity. Recommending a short-cage (SS) derailleur with a 51T largest cog results in jockey wheel contact and bent derailleur on the first ride in the easiest gear.
Is your cycling store missing cassette compatibility schema?
CatalogScan checks your Shopify store for missing freehub standard encoding, chain compatibility gaps, and speed count mismatches across your entire drivetrain catalog in under 2 minutes.
Run Free ScanFrequently Asked Questions
Can I install a Shimano 12-speed XT cassette on a standard HG freehub?
No. Shimano's 12-speed MTB cassettes (CS-M8100, CS-M9100, etc.) require a Microspline freehub body. The Microspline body has a 31mm OD vs the HG body's 34.75mm OD — physically incompatible spline patterns. To upgrade to 12-speed Shimano MTB, the rear hub must have a Microspline freehub body. Many hub manufacturers sell replacement Microspline freehub bodies that convert existing HG hubs (DT Swiss, Hope, Industry Nine have conversion kits for their respective hub models).
Are SRAM XD and XDR cassettes interchangeable?
No. XD (MTB) and XDR (road) bodies differ by 1.85mm in width. An XD cassette on an XDR hub overhangs toward the frame; an XDR cassette on an XD hub shifts the chainline outboard. Both cause drivetrain problems. Always match the cassette's freehub_standard to the hub body variant: xd for MTB, xdr for road/gravel.
Will a 12-speed chain work on my 11-speed cassette?
No. 12-speed chains (5.25mm outer width) are 0.37mm narrower than 11-speed chains (5.62mm). On an 11-speed cassette, the narrower chain rattles in the wider tooth gullets under load, causing ghost shifting. Chain speed count must match cassette speed count exactly.
Can I mix Shimano cassette with SRAM rear derailleur?
Within the same speed family and type (road or MTB), Shimano HG cassettes and SRAM HG cassettes are interchangeable on HG freehubs — a Shimano 11-speed cassette works fine with an SRAM Rival 11-speed derailleur and shifter. What matters is that the shifter, derailleur, and cassette all use the same actuation ratio for that speed count and system type (road or MTB). Check cassette.system_type — a Shimano 11s road cassette with an SRAM MTB 11s derailleur will not index correctly because actuation ratios differ.
What's the minimum sprocket size each freehub supports?
HG freehub (34.75mm OD): 11T minimum. Microspline (31mm OD): 10T minimum — the smaller body diameter is specifically designed for 10T engagement. SRAM XD/XDR (12-spline): 10T minimum. Campagnolo N3W: 9T minimum. The minimum cog size directly determines which 1x drivetrain ratios are achievable — a standard HG hub cannot run the 10T smallest cog required for many 1x road and gravel setups.
Related Guides
- Shopify Bicycle Bottom Bracket Schema — BSA vs BB30 vs PF30 vs BB86 vs T47 Shell Standards, Shimano vs SRAM DUB vs GXP Spindle Incompatibility
- Shopify Bicycle & Cycling Equipment Schema — Frame Size, Wheel Diameter, Groupset Compatibility
- Shopify Bicycle Inner Tube & Tire Schema — Bead Seat Diameter, Tubeless Compatibility
- Blog: Bicycle Drivetrain Compatibility — Freehub Standards, Chain Width, BB Shells, Electronic Groupsets
- Shopify Power Tool Battery Platform Schema — Voltage and Platform Lock-In