Skip to main content

Documentation Index

Fetch the complete documentation index at: https://spreecommerce.org/docs/llms.txt

Use this file to discover all available pages before exploring further.

Multi-vendor capabilities are only available in Spree Enterprise Edition.
Running a marketplace means juggling relationships with potentially dozens or hundreds of vendors — each at a different stage of onboarding, with their own product catalogs, revenue trajectories, and operational needs. The Vendors tab is mission control for all of it. From a single page, you can see the status of every vendor, dig into any individual vendor’s full profile to manage their branding, commission rate, payout schedule, and storefront policies, and review their products, orders, and team in detail. Whether you’re approving a new vendor that just finished onboarding, troubleshooting one that’s stuck, or pulling lifetime revenue figures for a top performer, this is where it all happens. To get started, navigate to Vendors in the admin dashboard.

​
Vendor List Overview

The main table displays every vendor on your marketplace alongside key metrics and status indicators. The Vendors tab showing the full list of vendors with status, integration, and revenue columns The default columns are:
  • Name - the vendor’s brand or company name.
  • Status - the current state of the vendor relationship:
    • Invited - invitation sent, not yet accepted.
    • Onboarding - vendor is working through onboarding tasks.
    • Ready for Review - vendor has completed onboarding and is awaiting your approval.
    • Approved - vendor is live and selling on the marketplace.
    • Rejected - vendor was not approved during review.
    • Suspended - vendor’s access has been temporarily revoked.
  • Onboarding Progress - a count of completed onboarding tasks (e.g., 4/6).
  • Integration - the vendor’s connection type:
    • Shopify
    • WooCommerce
    • N/A (Manual/CSV vendors)
  • Products - total number of products in the vendor’s catalog.
  • Revenue - lifetime sales generated by the vendor.
  • Commission - lifetime commission your marketplace has earned from the vendor.
  • Created At - when the vendor was first invited.
From this view you can apply filters, sort by any column, customize the visible columns, and export the data by clicking Export in the top right corner.

​
Managing a Vendor

To manage a specific vendor, click their row in the table to open their full vendor profile. A vendor profile page showing the branding panel, onboarding progress, and account information sections From the vendor profile you can view and configure the sections below.

​
Branding

The Branding panel of the vendor profile with fields for About, Logo, Square Logo, and Cover Photo Click Edit at the top of the profile to open the branding panel. You can configure:
  • About - a short description of the vendor.
  • Logo - the vendor’s primary logo (rectangular formats supported).
  • Square Logo - recommended for avatars and compact display areas.
  • Cover Photo - a wider banner image, similar to a Facebook cover photo.
These assets may be displayed on the vendor’s storefront pages and within their vendor dashboard.

​
Onboarding Progress

The Onboarding Progress section showing a checklist of completed and outstanding tasks A detailed breakdown of which onboarding tasks the vendor has and hasn’t completed. This helps you:
  • Identify blockers that are holding a vendor up.
  • Follow up with vendors who are stuck mid-flow.
  • Approve vendors once they’ve met all the requirements.
For a walkthrough of what vendors see during onboarding, see Shopify, WooCommerce, or Manual/CSV Vendor Onboarding.

​
Account Information

The Account Information section displaying commission rate, product count, total sales, and country A quick snapshot of vendor performance and financial terms:
  • Commission Rate - the rate currently applied to this vendor. Click the pencil icon to update.
  • Number of Products - total products in the vendor’s catalog.
  • Total Sales - lifetime sales generated by the vendor.
  • Country / Location - the vendor’s registered country.
For more on how commission rates work across the marketplace, see Commission Rates.

​
Payments & Payouts

The Payments & Payouts section showing the Stripe Account ID and payout schedule dropdown If the vendor is using Stripe Connect, you can manage their payout setup here:
  • Stripe Account ID - copy the vendor’s Stripe Account ID for reference or support purposes.
  • Payout Schedule - how often the vendor receives payouts. Options:
    • Daily
    • Weekly
    • Bi-weekly
    • Monthly
    • Use Marketplace Default Interval
Stripe Connect is only available in Spree Enterprise Edition. If your marketplace uses a different payment provider, payout schedule controls won’t be available here.
For more on configuring payout schedules across the marketplace, see Vendor Payouts.

​
Returns & Billing Address

The Returns & Billing Address section displaying the vendor's registered addresses These sections display the vendor’s registered returns and billing addresses. Both are view-only — vendors update their own addresses from their vendor dashboard.

​
Vendor Subtabs

Similar to customer profiles, the vendor profile includes several subtabs for deeper management of the vendor’s activity. The row of subtabs on a vendor profile, including Overview, Products, Orders, Users, Invitations, and Policies

​
Overview

A sales-over-time graph and a list of the vendor’s top-performing products — useful for a quick performance read at any point.

​
Products

Every product associated with the vendor. From here you can apply filters, sort results, perform bulk actions, and review product-level performance.

​
Orders

Every order placed with the vendor. You can filter orders, review payment and shipment states, and monitor fulfillment activity.

​
Users

All vendor users associated with the account — that is, users who have accepted invitations and now have access to the vendor dashboard. Useful for tracking who on the vendor’s team has access.

​
Invitations

All invitations sent to vendor users. From this tab you can see invitation status, copy pending invite links, and monitor which users haven’t yet joined.

​
Policies

The vendor’s policies, including:
  • Returns Policy (default)
  • Any other policies you require from the vendor
Admins can edit these policies directly from this section.