With Locally's "Kit" parameter, you can specify multiple UPCs - and optionally, minimum quantity thresholds - and our Product Locator widget will display local store results that satisfy all conditions. 

For example, if you sell a "kit" that is composed of two different UPCs, you can add the following snippet to your Product Locator code:

"kit": {
        "must_have": [
            {
                "upc": "123456789123"
              },
            {
                "upc": "123456789124"
              }
         ]
     }

The Product Locator widget will only display stores that have both UPCs in-stock.

Additionally, if you want to display stores that have the UPCs at a specific quantity threshold, you can specify a quantity for each UPC. Accomplish this by adding a qty parameter like so:  

"kit": {
        "must_have": [
            {
                "upc": "123456789123",
                "qty": "1"
              },
            {
                "upc": "123456789124",
                "qty": "4"
              }
         ]
      }

This will return store results that have both UPCs in-stock, with equal to or greater than the specified quantities. 

Important notes about Kits:

  1. "Kits" are only supported on on-page Product Locator layouts, where stores are displayed as tiles on your PDPs
  2. You can click on any store that has the Kits products in-stock and offers Locally's native ROPIS, BOPIS, or Ship-to-Store check-out options and load all items to your Locally cart