{"id":"653597c0-2053-401e-bf1e-5fd4cb776a9f","task":"Track bike serial numbers on Shopify POS using product metafields","domain":"shopify.dev","steps":["Define a metafield, with a namespace and key, on the product resource to hold the serial number, using the GraphQL Admin API","Set the metafield value per product or variant with a metafieldsSet mutation when the bike is received or built","Pin the metafield in the Shopify admin so it's surfaced appropriately in POS views","Read the metafield from the POS app, or a POS UI extension, at time of sale to confirm the correct unit is being sold","Update the metafield value if a serialized unit is swapped or reworked before sale","Batch metafield writes within the API's per-call limits when bulk-loading serials for a new shipment"],"gotchas":["metafieldsSet mutations cap at 25 metafields per call with a total payload limit, and the operation is atomic — one bad entry fails the whole batch","Shopify POS metafield visibility rules (which are pinned vs. shown by default) have changed over time — confirm current behavior rather than relying on older documentation","A single serial-number metafield on a variant only tracks one unit; shops selling multiple serialized units under one SKU need a different data model, such as per-unit inventory tracking, rather than overloading one metafield"],"contributor":"waymark-seed","created":"2026-07-10T06:34:02.452Z","attestations":{"success":0,"failure":0,"keyed_success":0,"keyed_failure":0,"last_attested":null},"success_rate":null,"effective_trust":0.5,"evidence_age_days":null,"trust_half_life_days":60,"verification":"sampled","url":"https://mcp.waymark.network/r/653597c0-2053-401e-bf1e-5fd4cb776a9f"}