How do I merge duplicate products in Breww?

If you've ended up with two products in Breww that represent the same thing (for example, the same beer in the same container type, accidentally created twice), you can combine them into a single product using the merge tool. This moves all stock, sales history, racking history, price book entries, sales-platform mappings and other related data from one product onto the other, then deletes the duplicate.

To start a merge, go to the product page you'd like to keep, then click Actions -> Merge duplicate products. You'll be shown a list of products in your brewery that are eligible to be merged into this one. Pick the duplicate, and Breww will walk you through resolving any conflicting field values (such as different names, SKUs, weights or trade store settings) before running the merge in the background.

Note: The product you start the merge from is the one that is kept. The product you select on the next screen is the one that will be deleted. If either of the products is mapped to your accounting software or a sales platform, start the merge from the product you'd like the combined product to keep using for those mappings.

What can be merged

The merge tool will only let you merge two products if they are genuinely interchangeable. Breww enforces the following:

  • Both products must be of a type that can be racked (i.e. they hold beer in containers - smallpack and largepack products). Mixed packs, raw ingredients and similar product types can't be merged.

  • Both products must use exactly the same set of component packaged beers, container types and quantities. Two products that contain Floral Haze IPA - 30L Keg (x1) can be merged together, but you can't merge Floral Haze IPA - 30L Keg into Floral Haze IPA - 50L Keg.

  • Neither product can be an alias product (alias products are automatically re-pointed to the kept product as part of the merge).

  • Part-filled products can only be merged with other part-filled products of the same underlying beer and container type.

    If the products you want to combine have different component packaged beers or container types, the merge tool won't offer them as candidates. In that case, the right approach is usually to obsolete the incorrect product and continue using the correct one - see How to correct an incorrectly set up product for the recommended workflow. If you genuinely need the two products to become one (for example, the wrong one has lots of stock and sales history you'd rather not lose), you can sometimes use a duty adjustment product (DAP) as a stepping stone to move stock onto the correct beer/container type combination first, and then merge - but this is an advanced workflow and we'd recommend reaching out to Breww support before attempting it.

What happens during the merge

Once you confirm the merge, Breww runs it as a background task. While it's running you'll see a progress indicator; once it finishes you'll be redirected to the kept product's page. Behind the scenes, Breww:

  • Combines stock levels at each location (so if both products had 10 units at the same site, the kept product ends up with 20).

  • Re-points all racking history, sales, deliveries, stock adjustments, stock takes and similar records to the kept product.

  • Merges tags, component stock items and sales-platform mappings (deduplicating where both products had the same entry).

  • Re-parents any alias products that pointed at the duplicate so they now point at the kept product.

  • Removes the duplicate from any price books.

  • Deletes the duplicate product.

Permissions

You'll only see the Merge duplicate products action if your user has the Manage products and pricing permission. If the action isn't visible on a product where you expect it, ask a brewery admin to check your user's permissions.

On this page