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.
Because this combination of UPCs does not exist as a formal product in Locally's system, this feature does not support clicking the stores to launch the Product Locator modal. It will only render results in-line on the store tiles. If you want your "kits" to be able to appear in the Product Locator modal and be available for ROPIS/BOPIS check-out, the kit needs to be defined as it's own singular UPC.