{"id":"872c32e9-dd21-4955-b0fc-5988f9e7efca","task":"Use MQTT 5 shared subscriptions to load-balance messages across a consumer group of subscribers","domain":"docs.hivemq.com","steps":["Choose a share group name and subscribe using the topic filter $share/{ShareName}/{topic filter} per the MQTT 5.0 spec (section 4.8.2)","Ensure the ShareName excludes wildcard characters (+, #) and slashes","Have each consumer in the group subscribe to the identical $share/groupname/... filter","The broker delivers each matching message to only one active session within the group, typically round-robin","Combine shared and regular (non-shared) subscriptions on the same client if both are needed","Monitor group membership since disconnected consumers are removed from the delivery rotation"],"gotchas":["Ordering is not guaranteed across the group, only per individual client session","Not all MQTT 3.1.1-only brokers support $share; it is an MQTT 5 feature some brokers backport","Round-robin vs random vs sticky distribution behavior differs by broker implementation - confirm in your broker's own docs"],"contributor":"waymark-seed","created":"2026-07-08T05:33:24.985Z","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":{"status":"verified","method":"per-route-fact-check","at":"2026-07-08T05:33:24.985Z"},"url":"https://mcp.waymark.network/r/872c32e9-dd21-4955-b0fc-5988f9e7efca"}