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.

TL;DR Freehub body standard is the first compatibility gate: HG (Shimano 8–11s), Microspline (Shimano 12s MTB), XD (SRAM MTB), XDR (SRAM road — 1.85mm narrower than XD, not interchangeable), Campagnolo N3W. Chain speed count must exactly match cassette speed count — 12s chain outer width is 5.25mm vs 11s at 5.62mm, and mixing causes ghost shifting or jamming. Minimum sprocket size depends on freehub OD: HG supports 11T minimum, Microspline/XD/XDR support 10T. Encode 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.

The same-brand trap: Shimano Hyperglide (HG) and Shimano Microspline are both manufactured by Shimano, use Shimano cassettes, and are completely physically incompatible. A customer upgrading from 11-speed to 12-speed Shimano MTB must replace the rear wheel or hub — their existing HG freehub will not accept the new cassette.

Freehub Body Standards Comparison

StandardODSpline PatternMin. CogCompatible CassettesLockring Tool
Shimano HG (Hyperglide)34.75mm8-spline with 1 wide spline11TShimano 8–11s MTB + road; SRAM 8–11s HGCN-21 cassette tool
Shimano Microspline31mmProprietary fine-tooth spline10TShimano 12s MTB only (CS-M9100, M8100, M7100, M6100)TL-FC38-B
SRAM XD34.8mm12 narrow splines10TSRAM Eagle 12s MTB (10-50T, 10-52T); XX1/X01/GX/NX EagleXD lockring socket
SRAM XDR34.8mm12 narrow splines (1.85mm narrower body)10TSRAM AXS road/gravel 11s + 12s (10-33T, 10-36T, 10-44T)XD lockring socket
Campagnolo N3W30.5mmProprietary 3-pawl spline9TCampagnolo 11s + 12s road cassettes onlyCampagnolo lockring tool
Campagnolo HG-compatible34.75mmHG-style spline11TCampagnolo 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 CountChain Outer WidthInner WidthCompatible With
8-speed7.1mm2.38mm8s cassette and derailleurs only; runs on 7s and 6s without indexing issues
9-speed6.7mm2.18mm9s cassette; Shimano and SRAM 9s derailleurs
10-speed6.2mm2.18mm10s cassette; road and MTB 10s systems
11-speed5.62mm2.18mm11s cassette (road and MTB); Shimano, SRAM, Campagnolo 11s derailleurs
12-speed (Shimano MTB)5.25mm2.18mm12s Shimano MTB cassette (Microspline) and M8100/M7100/M6100 derailleurs
12-speed (SRAM Eagle MTB)5.25mm2.18mm12s SRAM Eagle cassette (XD) and Eagle derailleurs
12-speed (SRAM AXS road)5.25mm2.18mm12s SRAM AXS road cassette (XDR)
13-speed (Campagnolo Ekar)5.15mm2.18mmCampagnolo 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

CombinationResultNotes
Shimano 11s cassette + SRAM 11s chainCompatibleChain width is the same (5.62mm); both HG-compatible on HG freehub
Shimano 11s cassette + Shimano 12s chainNot compatibleChain too narrow for 11s sprocket spacing — ghost shifting
SRAM Eagle cassette (XD) + Shimano 12s chainNot compatibleChain pitch matches but inner plate dimensions differ; Eagle requires SRAM Eagle-specific chain
Shimano 10s cassette + SRAM PG-1050 chainCompatibleBoth 10s; HG-compatible cassette on HG freehub
Campagnolo 11s cassette + Shimano 11s chainNot compatibleCampagnolo 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

GroupsetTypeCable Pull per ClickCompatible Shifters
Shimano 9-speed MTB (Acera, Alivio, Deore)MTB2.5mm9s MTB shifters only
Shimano 10-speed MTB (Deore, SLX, XT)MTB2.5mm10s MTB shifters; also compatible with 10s MTB Dynasys Shadow derailleurs
Shimano 11-speed MTB (XT M8000, SLX M7000)MTB2.3mm11s MTB shifters only; NOT same as 11s road
Shimano 12-speed MTB (XT M8100, SLX M7100)MTBElectronic (Di2) or 1.7mm mech12s MTB levers only; entirely new actuation family
Shimano 11-speed road (105, Ultegra, Dura-Ace)Road2.4mm11s road STI only; different from 11s MTB
Shimano 12-speed road Di2 (R9270, R8170)RoadElectronic12s 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 KeyTypeExample ValuesWhy Required
cassette.speed_countinteger8, 9, 10, 11, 12Hard chain and derailleur compatibility gate
cassette.freehub_standardsingle_line_text"hg", "microspline", "xd", "xdr", "campagnolo-n3w"Hard hub body compatibility gate
cassette.tooth_rangesingle_line_text"11-34", "10-51", "10-52", "11-28"Range determines required derailleur cage length
cassette.smallest_sprocket_teethinteger10, 11Freehub minimum engagement check
cassette.largest_sprocket_teethinteger28, 34, 42, 46, 51, 52Rear derailleur capacity check (cage length)
cassette.chain_pitch_mmdecimal5.62, 5.25, 6.2, 6.7Chain outer width compatibility
cassette.system_typesingle_line_text"road", "mtb", "gravel"Derailleur actuation ratio family
cassette.brand_seriessingle_line_text"deore-xt-m8100", "gx-eagle", "rival-xplr"Series-specific compatibility (esp. electronic)
cassette.materialsingle_line_text"steel", "aluminum", "steel-aluminum-mixed", "titanium"Weight and durability data for AI agent comparison
cassette.spider_mountbooleantrue, falseTrue = aluminum spider with removable small cogs (XTR, XX1)
cassette.lockring_toolsingle_line_text"tl-fc38-b", "xd-lockring-socket", "cn-21-cassette-tool"Required installation tool — often sold separately
cassette.minimum_rd_capacity_teethinteger35, 41, 48Minimum rear derailleur total capacity required
cassette.weight_gramsinteger265, 390, 480Component selection comparison
cassette.freehub_body_od_mmdecimal34.75, 31, 30.5Hub 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

  1. 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.
  2. 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_standard values.
  3. 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.
  4. 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.
  5. 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 Scan

Frequently 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