Shopify Mechanical Keyboard Switch Schema — Actuation Force gf, Actuation Point mm, Linear vs Tactile vs Clicky, Hot-Swap, 3-Pin vs 5-Pin, Structured Data

Why Keyboard Switches Are Structurally Invisible to AI Shopping Agents

Mechanical keyboard switch buying is driven by a precise matrix of physical specifications that are nearly always absent from structured data: a buyer searching "silent tactile switches, 67gf, 5-pin, lubed from factory" is specifying four independent properties simultaneously. The typical Shopify listing for a set of switches encodes none of these as machine-readable properties — all four appear only in the product description as prose text. An AI shopping agent cannot satisfy a multi-filter switch query without all four values in structured data.

Actuation force in gram-force is the primary tactile feel differentiator and the most commonly searched numeric specification. The range spans from 35gf (Gateron Yellow, extremely light) to 80gf (Cherry MX Black, heavy linear) — a difference that is profound for typing feel and completely invisible to an AI agent that reads only a product title like "Gateron G Pro Mechanical Switches 35 Pack." The 35 in that title refers to pack quantity, not actuation force. Without actuation force as a separate numeric property, pack-size numbers pollute AI agent matching against force specifications.

Pin configuration (3-pin vs 5-pin) determines physical PCB compatibility without modification. A 5-pin switch in a 3-pin-only PCB requires clipping — an irreversible modification. Budget hot-swap boards (many under $50) only accept 3-pin. Many mid-range and high-end boards accept both. Without pin configuration as a separate property, buyers who purchase 5-pin switches for a 3-pin-only board face an incompatibility that Shopify's schema does not flag. This is one of the highest-return-rate compatibility errors in the mechanical keyboard category.

Housing material determines the acoustic profile — arguably the second most searched characteristic after switch type. Polycarbonate (PC) housing produces a sharp, clacky sound with enhanced RGB light transmission. Nylon PA66 housing produces a warmer, more muted sound. POM (polyoxymethylene) housing is smoother and faster. These material differences produce audibly distinct keyboards that enthusiasts actively filter by. "Polycarbonate linear switches" is a real search query that requires housing material in structured data to answer.

Switch Type Reference — Linear, Tactile, Clicky

Actuation Force Reference

Housing Material — Sound Profile Reference

Complete Keyboard Switch Schema — Tactile 5-Pin 67gf

<script type="application/ld+json">
{
  "@context": "https://schema.org",
  "@type": "Product",
  "name": "Boba U4 Silent Tactile Switches — 67gf, 5-Pin, Nylon Housing (35-pack)",
  "description": "Silent tactile mechanical keyboard switches. 67gf actuation force, 2.0mm actuation point, 4.0mm total travel, 5-pin PCB mount, Nylon PA66 housing, POM stem. Factory unlubed. No audible click — tactile bump only. SMD LED compatible. Operating life: 60 million keystrokes. For PCB-mount and plate-mount keyboards (plate-mount requires removing 2 outer pins or use of switch films).",
  "sku": "BOBA-U4-67-35",
  "brand": { "@type": "Brand", "name": "Gazzew" },
  "additionalProperty": [
    {
      "@type": "PropertyValue",
      "name": "Switch Type",
      "value": "Tactile",
      "description": "Silent tactile switch. Pronounced tactile bump at the actuation point (2.0mm) — the bump is created by U-shaped tactile legs on the POM stem contacting the center column of the housing. After the bump releases at approximately 2.2mm, the required force decreases before increasing again toward bottom-out. No audible click mechanism. Silent dampening integrated into the stem (dual silicone dampeners on stem legs): stem impacts top and bottom housing silently. Bottom-out sound: near-silent thud. Preferred by typists who want tactile feedback without noise in shared office or late-night environments."
    },
    {
      "@type": "PropertyValue",
      "name": "Actuation Force",
      "value": "67",
      "unitCode": "GRM",
      "description": "Actuation force: 67gf (gram-force). The force required at the keycap stem to register a keypress, measured exactly at the 2.0mm actuation point. This is a heavier switch by mainstream standards (Cherry MX Red = 45gf, Cherry MX Brown = 55gf) — chosen by typists who prefer more resistance to prevent accidental keypresses. Tactile peak force (the maximum force required to push through the bump) is approximately 75gf before it releases. After the bump releases, the force requirement drops to approximately 55gf before increasing to bottom-out."
    },
    {
      "@type": "PropertyValue",
      "name": "Actuation Point",
      "value": "2.0",
      "unitCode": "MMT",
      "description": "Actuation point (pre-travel): 2.0mm. The distance the key must be depressed before registering a keypress. Industry standard is 2.0mm for most Cherry MX-compatible switches. Longer pre-travel (vs 1.5mm short-travel switches) provides a buffer zone before registration — reduces accidental keystrokes for heavy-handed typists. Compare: short-travel gaming switches at 1.0–1.5mm actuation reduce input latency by approximately 0.8–1ms (negligible in practice)."
    },
    {
      "@type": "PropertyValue",
      "name": "Total Travel",
      "value": "4.0",
      "unitCode": "MMT",
      "description": "Total travel: 4.0mm (from resting position to full bottom-out against housing floor). Standard MX-compatible total travel. The remaining 2.0mm after actuation (from 2.0mm to 4.0mm) constitutes the post-travel. Most typists bottom out switches even with deliberate non-bottom-out technique — bottom-out sound is the primary acoustic characteristic of the keyboard."
    },
    {
      "@type": "PropertyValue",
      "name": "Bottom-Out Force",
      "value": "75",
      "unitCode": "GRM",
      "description": "Bottom-out force: approximately 75gf. The force required to fully depress the switch to the housing floor. For tactile switches, bottom-out force is typically 5–15gf above actuation force. Silicone dampeners on the Boba U4 stem legs absorb the impact at both top-out (key returning to rest) and bottom-out (key fully depressed) — eliminating the sharp impact sound that makes non-dampened switches loud."
    },
    {
      "@type": "PropertyValue",
      "name": "Reset Point",
      "value": "1.6",
      "unitCode": "MMT",
      "description": "Reset point (key reset position): 1.6mm from resting. The distance from the bottom of travel at which the switch reregisters as 'up' after being pressed. Hysteresis (gap between actuation point 2.0mm and reset point 1.6mm) = 0.4mm. Smaller hysteresis allows faster repeated keystrokes before the key must fully return to rest position — important for rapid typing patterns like 'sss' (same key pressed rapidly)."
    },
    {
      "@type": "PropertyValue",
      "name": "Pin Configuration",
      "value": "5-Pin (PCB Mount)",
      "description": "5-pin PCB mount: two metal electrical contacts plus three plastic alignment pins (center, southwest, southeast). The two extra plastic pins prevent rocking and lateral play during keystroke — particularly noticeable for larger keys (spacebar, left shift) where wobble causes inconsistent feel. To use in a 3-pin-only PCB: clip the two outer plastic pins flush with the housing base using flush cutters (irreversible — do not clip metal contacts). Verify your keyboard's PCB before purchase: most hot-swap boards (Keychron, GMMK, Drop) accept 3-pin and 5-pin; some budget boards specify 3-pin only."
    },
    {
      "@type": "PropertyValue",
      "name": "Hot-Swap Compatible",
      "value": "true",
      "description": "Compatible with hot-swap PCB sockets (Kailh hot-swap sockets, Mill-Max 0305/7305, and Gateron KS-33 sockets). Switches can be installed and removed without soldering by pressing straight into the socket. Hot-swap socket type is a keyboard property, not a switch property — this switch is compatible with any MX-footprint hot-swap socket. Also compatible with soldered PCBs via standard through-hole soldering."
    },
    {
      "@type": "PropertyValue",
      "name": "SMD LED Compatible",
      "value": "true",
      "description": "SMD (Surface Mount Device) LED compatible: the bottom housing has an opening on the south side that accommodates SMD LEDs mounted to the PCB directly beneath the switch. This allows per-key RGB or single-color LEDs to illuminate through the keycap stem hole. Note: the Boba U4 has a milky white housing that diffuses LED light — RGB colors appear softer and more pastel compared to transparent (polycarbonate) housings. Not compatible with through-hole LED pins (the LED would occupy the south contact hole)."
    },
    {
      "@type": "PropertyValue",
      "name": "Housing Material",
      "value": "Nylon PA66 (top and bottom)",
      "description": "Top and bottom housing material: Nylon PA66 (glass-fiber reinforced polyamide 6,6). Produces a warm, muted acoustic profile — a property enthusiasts describe as 'thocky' or 'creamy'. Nylon PA66 has slight flex that absorbs some impact sound. Less sharp than polycarbonate (PC) housing; warmer than POM. The milky white color of Boba U4 housing results from the nylon PA66 formulation — identical to Gateron Milky Yellow housing. Lubing nylon housings (with Krytox 205g0 or Tribosys 3203) reduces the slight surface roughness and deepens the sound profile further."
    },
    {
      "@type": "PropertyValue",
      "name": "Stem Material",
      "value": "POM",
      "description": "Stem material: POM (polyoxymethylene, also called Delrin or acetal). Self-lubricating polymer — POM stem in nylon housing creates a naturally smooth travel feel without factory lube. The U-shaped tactile legs on the POM stem create the tactile bump against the housing column. Factory unlubed: enthusiasts commonly apply a thin coat of Krytox 205g0 to the stem legs (avoiding the tactile legs on tactile switches, or the tactile bump is muted) for reduced spring ping and improved sound."
    },
    {
      "@type": "PropertyValue",
      "name": "Factory Lubrication",
      "value": "Unlubed",
      "description": "Factory lubrication status: unlubed (dry). Switches are shipped without lubricant applied to stem, housing, or spring. This is the enthusiast-preferred default — allows the buyer to apply their own lubricant to their specific preference. Recommended lubricants: Krytox 205g0 (applied to housing rails and bottom of stem only — avoid tactile legs on tactile switches), Tribosys 3203 (thinner viscosity, less impact on tactile feel). Spring: bag lube with Krytox 105 oil to eliminate spring ping. Factory-lubed alternative: Gazzew Boba U4T (lubed variant) for buyers who prefer plug-and-play."
    },
    {
      "@type": "PropertyValue",
      "name": "Operating Life",
      "value": "60000000",
      "description": "Operating life: 60 million keystrokes per switch. Tested per the ANSI/INCITS 154 keyboard switch test standard. At an average typing speed of 60 WPM with 5 characters per word, 60 million keystrokes = approximately 200,000 hours of continuous typing — effectively a lifetime product for most users. Spring failure (the most common mechanical failure) is rated separately and typically exceeds switch housing life."
    }
  ],
  "offers": {
    "@type": "Offer",
    "price": "18.99",
    "priceCurrency": "USD",
    "availability": "https://schema.org/InStock"
  }
}
</script>

Metafield Reference Table — Keyboard Switches

Liquid Snippet — kb_switch Metafields to JSON-LD

{% assign sw = product.metafields.kb_switch %}
{% if sw.switch_type != blank %}
<script type="application/ld+json">
{
  "@context": "https://schema.org",
  "@type": "Product",
  "name": {{ product.title | json }},
  "additionalProperty": [
    { "@type": "PropertyValue", "name": "Switch Type", "value": {{ sw.switch_type | json }} },
    { "@type": "PropertyValue", "name": "Actuation Force", "value": {{ sw.actuation_force_gf | json }}, "unitCode": "GRM" },
    { "@type": "PropertyValue", "name": "Actuation Point", "value": {{ sw.actuation_point_mm | json }}, "unitCode": "MMT" },
    { "@type": "PropertyValue", "name": "Total Travel", "value": {{ sw.total_travel_mm | json }}, "unitCode": "MMT" },
    { "@type": "PropertyValue", "name": "Bottom-Out Force", "value": {{ sw.bottom_out_force_gf | json }}, "unitCode": "GRM" },
    { "@type": "PropertyValue", "name": "Pin Configuration", "value": {{ sw.pin_config | json }} },
    { "@type": "PropertyValue", "name": "Hot-Swap Compatible", "value": {{ sw.hot_swap_compatible | json }} },
    { "@type": "PropertyValue", "name": "SMD LED Compatible", "value": {{ sw.smd_led_compatible | json }} },
    { "@type": "PropertyValue", "name": "Housing Material", "value": {{ sw.housing_material | json }} },
    { "@type": "PropertyValue", "name": "Factory Lubrication", "value": {{ sw.factory_lube | json }} },
    { "@type": "PropertyValue", "name": "Operating Life", "value": {{ sw.operating_life_m | append: ' million keystrokes' | json }} }
  ]
}
</script>
{% endif %}

Five Common Keyboard Switch Schema Mistakes

• Pack quantity number confused with actuation force. "Gateron Yellow 35 Pack" — the 35 refers to switch count, not actuation force. AI agents matching "35gf switches" can incorrectly return products where 35 is the pack size. Encode actuation force as a separate numeric additionalProperty with unitCode: "GRM" — never let force and quantity share a product title number.
• Switch type without tactile bump description. "Tactile switch" with no bump description forces the AI agent to treat Cherry MX Brown (barely perceptible 55gf bump) and Holy Pandas (pronounced 67gf bump) identically. The tactile intensity and bump position relative to actuation point are critical search filters for experienced buyers. Include bump position (pre-travel, at actuation, or post-actuation) and approximate peak force in the description.
• Missing pin configuration. 3-pin vs 5-pin is the most common PCB compatibility error in the keyboard category. A buyer with a 3-pin-only board who receives 5-pin switches must either clip the pins (irreversible) or return the product. Encode pin configuration as an explicit property on every switch listing — it is the physical compatibility specification.
• Housing material absent. "Nylon housing switches" and "polycarbonate housing switches" are explicitly searched queries — housing material is the acoustic fingerprint of a switch. The difference between PA66, PC, and POM housing is immediately audible and drives significant buying decisions among keyboard enthusiasts. Always encode top and bottom housing material separately (they are sometimes different: polycarbonate top, nylon bottom).
• Factory lube status missing. "Factory lubed" vs "unlubed" is a binary property with significant impact on typing experience and sound. Many enthusiasts explicitly buy unlubed to apply their preferred lubricant; others buy factory-lubed for convenience. The lubricant type (Krytox 205g0, Tribosys 3203, generic grease) matters to intermediate buyers. Encode the factory lubrication status and lubricant name explicitly.

Related guides

• Shopify Electronics & Hardware Schema — general electronics structured data
• Shopify Audio & Headphones Schema — impedance, driver, ANC, codec
• E-Commerce Product Schema Markup — complete Product JSON-LD guide
• Shopify Metafields for AI Agents — namespace strategy and type reference