A complete walkthrough for store owners and administrators to set up and manage the Field B2B app in Shopify Admin.
Install
→
Add Reps
→
Set Up Companies
→
Assign
→
Configure
→
Monitor
▶Use arrow keys or the buttons below to navigate. Press Ctrl+P to print / export as PDF.
Overview
What We'll Cover
1Dashboard Overview
2Managing Sales Reps
3Sales Managers & Override Commission
4Companies & Customers
5Assignments (Rep ↔ Company)
6Analytics & Reporting
7Commissions
8Settings & Branding
9Billing & Plans
10FAQs & Troubleshooting
Section 1
The Dashboard
Your command center — key metrics, revenue trends, and quick actions at a glance
Field B2B — Dashboard
Dashboard
Total Quotes
47
+23%
Conversion Rate
34%
+5pp
Revenue
$18,400
+31%
Avg Quote
$391
-8%
Commissions
$1,840
+31%
Active Reps
4
Revenue Trend (30 days)
Mar 1Mar 10Mar 20Mar 30
QuotedConverted
Section 1 (continued)
Dashboard Features
📈
30-Day Metrics
Total quotes, conversion rate, revenue, average quote value, commissions, and active rep count — all with % change indicators.
📊
Revenue Trend Chart
Visual line chart showing quoted value vs. converted revenue over the past 30 days with interactive data points.
🏆
Top Reps Leaderboard
Top 5 sales reps ranked by revenue. Click a rep name to view their full detail page.
📱
Portal QR Code
Scannable QR code linking to the rep portal. Print it out or share with your sales team for quick access.
🎓
Guided Tour
8-step interactive walkthrough for new admins. Tap "How it Works" to learn the entire setup process.
⚡
Quick Actions
One-tap access to Analytics, Commissions, Manage Reps, and Assignments directly from the dashboard.
Section 2
Managing Sales Reps
Create, edit, and manage your sales team
Sales Reps
Sales Reps
Name
Email
Phone
Manager
Status
Mike JohnsonManager
mike@company.com
(303) 555-0142
—
Active
Emily Chen
emily@company.com
(503) 555-0198
Mike Johnson
Active
Carlos Rivera
carlos@company.com
(512) 555-0167
Mike Johnson
Active
Amanda Lee
amanda@company.com
—
—
Inactive
💡The Manager column shows who each rep reports to, and a Manager badge marks the reps who lead a team. Both are set on the rep's detail page.
Section 2 (continued)
Adding a New Rep
Add Sales Rep
Add Sales Rep
Leave empty to use default rate
Leave empty for no limit
Section 2 (continued)
Rep Created!
Copy the auto-generated credentials — the password is shown only once
Rep Created
Sales rep created successfully!
Login Credentials
Email: mike@company.com
Password: xK9#mP2vL8
This password will not be shown again. Make sure to copy it now.
⚠Share credentials securely with the rep. If they lose their password, use Reset Password on the rep detail page to generate a new one.
Section 2 (continued)
Rep Detail Page
Edit info, manage status, reset password, or delete
Mike Johnson
Mike Johnson
Rep Information
Commission & Discount
Team
A manager cannot report to another manager
Leave blank to use the store default
Summary
Status:Active
mike@company.com
(303) 555-0142
Commission: 12%
Max discount: 15%
Manages 2 reps
Portal QR Code
▦
Scan to open portal
Section 3
Sales Managers
Promote a rep to lead a team — they keep selling, and they earn on their team’s sales too
1
Promote a rep. On the rep’s detail page, tick This rep is a manager and save. Nothing else changes — they keep their own accounts, their own quotes, and their own commission rate.
2
Assign their team. Open each rep who should report to them and pick the manager under Reports to. The dropdown only lists reps you have already made managers.
3
Set the override rate (optional). Leave it blank and the manager earns the store default from Settings. Set 0 and they earn no override at all.
👁
What a manager sees
Their team’s quotes, companies and customers, plus a Team tab listing each rep’s quote count and earnings.
🔒
What a manager cannot do
Send, convert, edit or delete a team member’s quote. Managers get visibility, not control — quotes stay with the rep who wrote them.
🏗
One level only
A manager cannot report to another manager. Assigning a manager to a rep who already leads a team is rejected.
⚠Demoting a manager releases their team. Un-ticking the box asks you to confirm, then clears every rep’s Reports to field. The reps themselves are untouched.
Section 3 (continued)
Override Commission
A manager’s cut of their team’s sales — added on top, never taken from the rep
Order #1039 — $4,488
Emily converts a $4,488 quote. She is on 8%; her manager Mike is on a 2% override.
Rep
Type
Rate
Applied to
Amount
Emily Chen
Auto
8%
$4,488 order total
+$359.04
Mike Johnson
Manager override
2%
$4,488 order total
+$89.76
+
Added, not split. Emily still earns her full $359.04. Both rates apply to the order total, never to each other — so this order costs you 10% in commission, 8% + 2%. A 2% override across a five-rep team adds 2% to every sale those reps make.
⇄
The two rows move together. When the order is paid, both go Confirmed. If it is cancelled or refunded, both are reversed proportionally.
○
Only real sales fan out. Manual adjustments never generate an override, and a manager with no override rate — or a rate of 0 — generates no row at all.
Section 4
Companies & Customers
Two modes: Shopify B2B sync or app-managed companies
🌐
Shopify B2B Mode
Sync companies from Shopify Admin. Best for Shopify Plus stores with B2B already enabled. Companies, locations, and contacts are managed in Shopify.
Requires Shopify Plus
🛠
Manage in App
Create and manage companies directly in Field B2B. Works with any Shopify plan. Set custom discounts per company.
Any Shopify Plan
💡You choose your mode in Assignments or Settings. You can switch modes at any time.
Section 4 (continued)
Companies List
Companies
Companies
Name
External ID
Locations
Customers
Acme Hardware Inc.
ACM-001
2
3
Summit Outdoor Supply
SOS-042
1
2
Mountain Gear Co.
—
1
1
Section 4 (continued)
Creating a Company
App-managed mode: set up companies with custom discounts
Create Company
Create Company
Use your ERP or CRM identifier
e.g. 20 for 20% off retail. Applied to all products for this company.
Section 4 (continued)
Company Detail
1
Edit company info: name, external ID, and default discount percentage
2
Manage locations: add, edit, or delete shipping locations with country & currency
3
Add customers: search existing Shopify customers and link them to the company
4
Remove customers: unlink a customer from the company
5
Delete company: removes all locations and assignments (quotes are preserved)
💡Shopify B2B mode: Company details are read-only and synced from Shopify. Use "Manage in Shopify" to make changes.
⚠A company must have at least one location. The last location cannot be deleted.
Section 5
Rep ↔ Company Assignments
Control which companies each sales rep can access in the portal
Assignments
Assignments
Sales Reps
Name
Co.
Mike Johnson
2
Emily Chen
1
Carlos Rivera
3
Companies for Mike Johnson
Company
Locations
Contacts
Acme Hardware
2
3
Unassign
Summit Outdoor
1
2
Unassign
Mountain Gear
1
1
Assign
Section 5 (continued)
How to Assign
1
Select a rep from the left panel — their assigned companies appear on the right
2
Tap Assign next to a company to give the rep access
3
Tap Unassign to revoke access
4
Use the search bar to filter companies by name
5
Changes take effect immediately — the rep will see the company in their portal right away
💡A rep can be assigned to multiple companies, and a company can be assigned to multiple reps. This is many-to-many.
⚠If a rep has no assignments, they'll see "No companies assigned" after logging in. Make sure every active rep has at least one company.
Section 6
Analytics & Reporting
Track performance with three report views
Analytics
Analytics
OverviewRep PerformanceTop Companies
7 days30 days90 daysAll timeCustom
Total Quotes
47
+23%
Conversion
34%
+5pp
Revenue
$18.4k
+31%
Avg Quote
$391
-8%
Quote Funnel
Created47
Sent38-19%
Converted16-58%
Revenue Calendar
SMTWTFS
Section 6 (continued)
Rep Performance
Compare reps by quotes, conversions, and revenue — with CSV export
Analytics — Rep Performance
OverviewRep PerformanceTop Companies
#
Rep ↕
Quotes ↕
Converted ↕
Conv. Rate ↕
Revenue ↓
1
Mike Johnson
18
8
44%
$8,200
2
Carlos Rivera
16
5
31%
$6,100
3
Emily Chen
13
3
23%
$4,100
💡Click any column header to sort ascending or descending. The Export CSV button downloads the current view for use in spreadsheets.
Section 6 (continued)
Top Companies
See which companies generate the most revenue
Analytics — Top Companies
OverviewRep PerformanceTop Companies
#
Company
Quotes
Revenue
Avg Value
Last Activity
1
Acme Hardware
14
$9,800
$700
Today
2
Summit Outdoor
11
$5,200
$473
2 days ago
3
Mountain Gear
6
$3,400
$567
1 week ago
💡Use the period selector (7d, 30d, 90d, all time, custom) on any analytics tab to adjust the date range. Custom lets you pick exact start and end dates.
Section 7
Commissions
Track earnings, view history, and create manual adjustments
Commissions
Commissions
Total
$4,280
18 commissions
Confirmed
$3,080
12 confirmed
Pending
$1,200
6 awaiting payment
Pending — commission created when a quote converts to an order. Awaiting payment. Confirmed — order has been paid. Commission is ready for payout.
Per-Rep Breakdown
Rep
Commissions
Total
Mike Johnson
8
$1,840
Carlos Rivera
5
$1,280
Emily Chen
5
$1,160
Section 7 (continued)
Commission History
Recent Commissions
Date
Rep
Type
Status
Order
Rate
Amount
Mar 12
Mike Johnson
Auto
Confirmed
#1024
12%
+$450
Mar 10
Carlos Rivera
Auto
Pending
#1019
10%
+$380
Mar 10
Mike Johnson
Manager override
Pending
#1019
2%
+$76
Mar 8
Emily Chen
Manual
Confirmed
Bonus
—
+$200
A
Auto commissions are created automatically when a quote converts to an order. They start as Pending and become Confirmed once the order is paid.
M
Manual adjustments are bonuses or deductions you create for special cases. They are always Confirmed immediately.
O
Manager overrides appear as their own row against the same order as the sale that earned them — note #1019 above, credited to Carlos at 10% and to his manager Mike at 2%. Two rows, two people, one order. Filter the list by Manager override to see them alone.
!
Two-stage tracking ensures you only pay commissions on orders that are actually paid — pending commissions are visible to reps for transparency but not counted for payout.
Section 7 (continued)
Manual Adjustments
Add bonuses or deductions for any rep
Manual Adjustment
Use positive for bonuses, negative for deductions
💡Use the Export CSV button on the per-rep breakdown to download commission data for payroll processing.
Section 8
Settings & Branding
Configure your business info, quote templates, portal theme, and more
🏢
Business Info
Name, phone, address, website, and logo. Appears on quote PDFs and the portal header.
Applied to all reps unless overridden individually
Added on top of the rep’s commission — not deducted from it
Section 8 (continued)
Portal Design Patterns
8 built-in themes to match your brand identity
✨
Modern
Rounded corners, clean sans-serif (default)
📜
Classical
Sharp corners, serif headings
🔥
Bold
High contrast, strong shadows
◻
Minimal
Ultra-clean, thin borders
⚪
Rounded
Extra-round corners, soft feel
iOS
Apple HIG, grouped sections
🤖
Android
Material 3, rounded buttons
💻
Windows
Fluent Design, crisp edges
🎨Combine a design pattern with your brand color to create a portal that feels like your own app. Changes apply instantly to the rep portal.
Section 9
Billing & Plans
All plans include every feature — plans differ only by number of sales reps
Billing
Billing
All plans include every feature. Plans differ only in the number of sales reps allowed. A sales manager is a rep account, so they use a seat too.
Free
$0
1 sales rep
Starter Current
$29/mo
5 sales reps
Growth
$79/mo
15 sales reps
Business
$149/mo
Unlimited reps
Change your plan or update payment method on Shopify's billing page.
Section 9 (continued)
Included in All Plans
👤 Rep Portal
Secure login with credentials, works on any device
🛒 Product Catalog
Full catalog with B2B pricing overlay per company
📄 Quote Creation
Cart → quote → Shopify draft order with locked pricing
📄 PDF Generation
Branded PDF quotes with your logo and business info
✉ Email Quotes
Send quotes via email with checkout link and PDF
⚡ Quick Order
Bulk SKU entry with paste support and autocomplete
📈 Analytics
Revenue trends, rep performance, top companies, funnel
💰 Commissions
Auto-tracking, manual adjustments, CSV export
👥 Sales Managers
Team hierarchy, team-scoped visibility, and override commission on a team’s sales
🎨 Custom Branding
8 portal themes, brand color, logo, and business info
FAQ
Frequently Asked Questions
Q
Do I need Shopify Plus to use this app? No. The "Manage in App" company mode works with any Shopify plan. Shopify Plus is only required if you want to sync companies from Shopify's native B2B features.
Q
Can reps see each other's quotes or commissions? Ordinary reps, no. The one exception is a sales manager, who sees their own team's quotes, companies, customers and earnings — but never a rep outside their team.
Q
Does a manager's override reduce what the rep earns? No. It is a separate row for the manager, calculated on the order total and added on top. It does raise your cost: an 8% rep under a 2% manager costs you 10% on that order.
Q
What happens when a rep creates a quote? A draft order is created in your Shopify Admin with locked pricing. The customer receives a checkout link where they can complete payment. You can see the draft order in Shopify Admin → Orders → Drafts.
Q
Can I change the company mode later? Yes. Go to Settings and switch between Shopify B2B and Manage in App at any time. Existing quotes and assignments are preserved.
FAQ (continued)
More Questions
Q
How do B2B prices work? Shopify B2B mode: Prices come from your Shopify B2B catalog pricing. App-managed mode: A default discount percentage on the company is applied to retail prices (e.g., 20% off). Reps can add an additional discount on top.
Q
How are commissions calculated? When a quote converts to an order, the system creates a Pending commission using the rep's rate × order value. Once the order is paid, the commission is automatically Confirmed. This two-stage tracking ensures you only pay on revenue actually received. You can also add manual bonuses or deductions (always confirmed immediately).
Q
Can I set different discount limits per rep? Yes. Each rep has a "Max additional discount (%)" field. Leave it empty for no limit, or set a specific cap (e.g., 15%). The portal enforces this limit when reps apply discounts.
Q
What counts against my plan's rep limit? Every active rep — including sales managers, which are rep accounts with a flag on them. So the Free plan, with one seat, cannot have a manager and a rep at once. At the limit the "Add Rep" button is disabled; upgrade via Billing, or deactivate unused reps to free slots.
FAQ (continued)
Troubleshooting Issues
Q
A rep says they can't log in. Check their status on the Reps page — it may be Inactive. If active, use Reset Password to generate new credentials. Also ensure they're using the correct portal URL.
Q
Companies aren't showing up after Shopify B2B sync. Make sure your Shopify B2B companies have at least one location and one customer contact. Then go to Assignments or Companies and tap Sync from Shopify.
Q
A rep sees "No companies assigned" in the portal. Go to Assignments, select the rep, and assign at least one company. Changes take effect immediately — the rep just needs to refresh.
Q
My logo doesn't appear on PDFs. Go to Settings → Business Info and upload a logo or tap "Use Shopify Logo." Supported formats: PNG, JPG, SVG, WEBP (max 500KB). Tap Save after making changes.
Getting Started
Setup Checklist
Follow these steps to get your team up and running
1
Install the app and open it from Shopify Admin
2
Go to Settings — business info, logo, theme, commission and override rates
3
Choose your B2B company mode (Shopify B2B or Manage in App)
4
Go to Companies — create or sync your B2B companies
5
Go to Reps — add your sales reps and copy their credentials
6
Go to Assignments — assign companies to each rep
7
Optional: promote a rep to manager and assign their team
8
Share the portal URL and credentials with your reps — they're ready to sell!
Thank You
You're All Set!
Your B2B field sales team is ready to start selling
📈
Monitor Performance
Check the Dashboard and Analytics to track quotes, revenue, and rep activity
💰
Manage Commissions
Review pending/confirmed commissions and add manual bonuses as needed
🛠
Scale Your Team
Add more reps and companies as your B2B business grows
💬Need help? Take the Guided Tour from the Dashboard, or contact support for assistance.