16. Help Articles¶
Focused walkthroughs for advanced features. Each article is self-contained and can be linked directly to clients or team members.
16.1 Setting up Commissions (Sales Team & Dealers) (Pro)¶
Track who sold what and how much they earn — for both internal sales reps and external dealers — directly from the quote.
Overview¶
Remnant Finder supports two commission models that can coexist on the same quote:
| Model | Who it applies to | Where it is calculated |
|---|---|---|
| Sales Team | Internal users (team members of your company) | Quote totals page |
| Dealer / Margin | External resellers (clients flagged as dealer) |
Quote totals page, deducted as a markup |
Setting up a Sales Rep¶
- Go to Settings → Team.
- Open the team member you want to mark as a sales rep.
- Enable "Eligible for commission".
- Set a default commission rate (percentage) — this can be overridden per quote.
- Save.
The user now appears in the Sales Rep dropdown on every quote.
Setting up a Dealer¶
- Go to CRM → Clients.
- Open or create the client and set Client Type = Dealer.
- Set a default margin (percentage) on the client — used to calculate the markup applied to your prices when this dealer resells to the end customer.
- Save.
Applying commissions on a quote¶
On the Quote Summary screen:
- In the Sales Rep field, select the team member who handled the sale. The default commission rate is pre-filled and the commission amount is calculated against the quote subtotal.
- If the client is a Dealer, the dealer margin is automatically applied and shown on a separate line ("Dealer markup").
- Both values flow into the PDF, the invoice, and your financial reports.
Reporting¶
- Analytics → Financial → Commissions shows a breakdown by sales rep and by dealer for any date range.
- Each row links back to the source quote so you can audit how the commission was calculated.
Best practice
Set default commission rates at the team member level so you don't have to remember the number every time you create a quote. Override only when a special arrangement applies.
16.2 Adding Material Brands & Colors (Pro)¶
Build a structured catalog of the materials you actually sell, with brand-level and color-level pricing.
Concept¶
The pricing catalog is organized in three layers:
Material Type → Brand (Manufacturer) → Color
(Granite) (Caesarstone) (Pure White)
- A Material Type is the broad family (Granite, Quartz, Marble, Quartzite, Porcelain, …).
- A Brand is the manufacturer that produces a specific line of that material type (Caesarstone, Silestone, Cambria, …).
- A Color is the actual SKU sold — with its own price per square foot or per slab.
You can sell colors directly under a Material Type (no brand), or organize them under a Brand. Both styles work in the quote selector.
Adding a new Material Type¶
- Go to Settings → Pricing → Material Types.
- Tap + New Type.
- Enter a name (e.g., "Sintered Stone") and pick an icon.
- Save. The new type is now available in all quote selectors.
Adding a Brand¶
- From Settings → Pricing → Material Types, open the type you want to add a brand to.
- Tap + New Brand.
- Enter the brand name (e.g., "Caesarstone") and optionally upload the brand logo.
- Save.
Adding a Color¶
- Open the Material Type or Brand where the color belongs.
- Tap + New Color.
- Fill in:
- Name (e.g., "Pure White")
- Price per sqft or Per-slab price (toggle "Sold by the slab")
- Color swatch image (optional but recommended — it appears in the quote selector)
- Save.
Cascade selector in quotes¶
When designing a quote, the material selector follows the catalog hierarchy:
- Pick a Material Type → the Brand dropdown opens automatically.
- Pick a Brand (or skip if not used) → the Color dropdown opens automatically.
- Pick a Color → pricing is filled in.
This auto-open cascade also works inside additional Color Options (see 16.3).
Bulk import¶
For large catalogs:
- Go to Settings → CSV Import → Pricing.
- Download the template.
- Fill in
material_type,brand,color,price,price_unitcolumns. - Upload — the import creates missing types/brands automatically.
Avoid duplicates
The importer matches by name (case-insensitive). Use consistent spelling for brand names across rows.
16.3 Using Color Options for Quote Comparisons (Pro)¶
Offer your client two or three material choices in the same quote and let them compare prices side-by-side.
When to use it¶
- The client is undecided between a premium quartz and a budget granite.
- You want to upsell from a base color to a designer color.
- A designer/architect wants to evaluate the cost impact of different stones on the same layout.
Adding a Color Option to an area¶
In the Drawing Tool, on the area sidebar (right panel):
- Scroll to the Material section. The primary material is already configured.
- Tap + Add Color Option to add a second alternative.
- The cascade selector opens — pick Material Type → Brand → Color (each step auto-opens the next).
- Optionally give the option a label ("2nd Option", "Designer Choice", "Budget"). If left blank, the app uses an ordinal label.
- Repeat for up to 3 alternatives per area.
You can add Color Options on multiple areas — each area keeps its own list.
Switching between options¶
- The active option for each area is the one that drives the quote totals.
- Tap any option card to make it active. The summary totals refresh instantly.
- The original primary material is always preserved — you can return to it at any time.
Comparison Grid (Quote Summary)¶
When any area has 2+ options, the Quote Summary screen shows a collapsible "Compare Material Options" card. It contains a grid where:
- Each column is one option (Primary, 2nd Option, …).
- Each row is one area.
- Cells show the material cost for that area under that option, plus the delta (Δ) vs. the active selection — colored red if more expensive, green if cheaper.
- The footer row shows the total cost for each option across all areas.
The grid fills the available width and scrolls horizontally on small screens.
Comparison in the PDF¶
When you generate a Quote PDF, an additional "Material Options Comparison" table is rendered between the line items and the totals. It shows:
| Column | Meaning |
|---|---|
| Option | Name of the alternative (or "Current Selection" for the active) |
| Subtotal | Quote subtotal under that option |
| Tax | Tax amount under that option |
| Total | Final total under that option |
| Δ vs Default | Difference vs. the active total (red = more, green = less, — = 0) |
To keep the PDF readable, the table renders the active selection + up to 3 alternatives. If you have more, a small footnote indicates the count of options not shown — consider trimming the list before sending.
The comparison section is hidden when Show Price Details is disabled on the quote.
Sharing with the client¶
Three places the client will see the comparison:
- Quote Summary screen (in the Remnant Finder app, if you screen-share or invite them).
- PDF attached to the quote email (table format described above).
- Client Portal — when the quote is opened in the portal, each option appears as a selectable radio button. The client can pick their preferred option and the quote total updates accordingly.
Naming options well
Use descriptive labels like "Premium — Calacatta" or "Budget — Black Galaxy" instead of "Option 2". Clients are far more likely to engage with a comparison when each line tells them what they are looking at.
Need a topic we don't cover yet? Email support@remnantfinderapp.com and we'll add it.