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
3Companies & Customers
4Assignments (Rep ↔ Company)
5Analytics & Reporting
6Commissions
7Settings & Branding
8Billing & Plans
9FAQs & 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
Status
Mike Johnson
mike@company.com
(303) 555-0142
Active
Emily Chen
emily@company.com
(503) 555-0198
Active
Carlos Rivera
carlos@company.com
(512) 555-0167
Active
Amanda Lee
amanda@company.com
—
Inactive
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
Summary
Status:Active
mike@company.com
(303) 555-0142
Commission: 12%
Max discount: 15%
Portal QR Code
▦
Scan to open portal
Section 3
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 3 (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 3 (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 3 (continued)
Company Detail
1Edit company info: name, external ID, and default discount percentage
2Manage locations: add, edit, or delete shipping locations with country & currency
3Add customers: search existing Shopify customers and link them to the company
4Remove customers: unlink a customer from the company
5Delete 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 4
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 4 (continued)
How to Assign
1Select a rep from the left panel — their assigned companies appear on the right
2Tap Assign next to a company to give the rep access
3Tap Unassign to revoke access
4Use the search bar to filter companies by name
5Changes 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 5
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 5 (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 5 (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 6
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 6 (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 8
Emily Chen
Manual
Confirmed
Bonus
—
+$200
Mar 5
Mike Johnson
Auto
Confirmed
#1012
12%
+$170
AAuto commissions are created automatically when a quote converts to an order. They start as Pending and become Confirmed once the order is paid.
MManual adjustments are bonuses or deductions you create for special cases. They are always Confirmed immediately.
!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 6 (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 7
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
Section 7 (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 8
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.
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 8 (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
🎨 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? No. Each rep only sees their own quotes, commissions, and assigned companies. Rep data is fully isolated in the portal.
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 if I reach my plan's rep limit? The "Add Rep" button is disabled and a warning banner appears. Upgrade your plan via Billing to add more reps. You can also deactivate unused reps to free up 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
1Install the app and open it from Shopify Admin
2Go to Settings — configure business info, upload your logo, choose a portal theme
3Set the default commission rate and quote expiry
4Choose your B2B company mode (Shopify B2B or Manage in App)
5Go to Companies — create or sync your B2B companies
6Go to Reps — add your sales reps and copy their credentials
7Go to Assignments — assign companies to each rep
8Share 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.