For the complete documentation index, see llms.txt. This page is also available as Markdown.

Bulk Product Swap Beta Guide

Use the Swap Products feature to replace a product everywhere it appears on an estimate in a single action.

The Swap Products feature lets you replace products across an entire estimate or selected items.

Join Beta

This feature is currently in active development. You may encounter bugs, missing functionality, or things that don't work quite as expected. We're actively making improvements and would love your feedback if you run into anything!

Feel free to reach out to us at product@paintscout.com


How to Swap Products

1

Choose what you want to update

  • Entire estimate: Use Swap Products at the top of the estimate table. This replaces the product everywhere it appears.

  • Selected items: Select areas, surfaces, or line items. Then use Swap Products in the blue action bar. This affects only your selection.

After you select items, the estimate-wide Swap Products option disappears. This prevents accidental estimate-wide changes.

2

Open the Swap Products dialog

Once you've made your selection, open the Swap Products dialog.

3

Define your swap pairs

In the dialog, set up one or more swap pairs. For each pair:

  • From — the product currently on the estimate that you want to replace

  • To — the replacement product from your product library

Both dropdowns show helpful context for each product: substrate count, line item count, and volume. Archived products are excluded from both dropdowns.

You can add as many swap pairs as you need and apply them all at once.

Note: If the estimate has no products, the dialog will show a warning asking you to add products before proceeding.

4

Confirm

Click to apply the swaps. Selected-item swaps affect only selected substrates and line items. Estimate-wide swaps affect every matching product. A single recalculation runs after all swaps are applied.


Things to Know

  • Swaps are 1-to-1. Each swap replaces one specific product with one replacement. Partial or conditional replacements are not supported.

  • No validation on swap pairs. It's your responsibility to select an appropriate replacement product.

  • Recalculation happens once— after all swaps in the operation are applied. Not after each individual swap.

  • Archived products cannot be swapped. They won't appear in either the From or To dropdowns.

  • Swaps cannot be undone. Once applied, there is no way to reverse the action, so double-check your swap pairs before confirming.

  • Selected-item swaps use the blue action bar. The estimate-wide option is unavailable while items are selected.


FAQ

Can I swap a product on just part of an estimate?

Yes. Select only the specific areas, surfaces, or line items you want to affect before opening the dialog. Unselected items will not be changed.

Can I swap a product across the entire estimate?

Yes. Clear any item selections, then use Swap Products at the top of the estimate table. Every matching product on the estimate will be changed.

Can I swap multiple products at once?

The dialog supports multiple swap pairs in a single operation. Define as many from/to pairs as you need, then apply them all at once.

Will the swap affect archived products?

No. Archived products are excluded from both dropdowns and cannot be selected as a source or target.

What if my estimate has no products?

The dialog will display a warning prompting you to add products to your estimate first.

Will my estimate be recalculated after the swap?

Yes. A single recalculation runs after all swaps are complete.

What if I swapped the wrong product?

Swaps cannot be undone. Review your swap pairs carefully before confirming.


Thanks for Trying the Beta!

We're excited to have you trying out this new feature. Since this is actively in development, your feedback is incredibly valuable as we continue to improve.

If you have questions, run into issues, or just want to share your thoughts, please reach out anytime at product@paintscout.com

Thanks for helping shape what's next!

Last updated

Was this helpful?