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.

Marketplace settings are only available in Spree Enterprise Edition with the multi-vendor module enabled.
The Marketplace settings page is the central place to configure how vendors operate on your marketplace by default. It’s where you set the default commission rate new vendors will be invited under, how often vendors get paid, what merchants see when they install your Shopify app, and the terms of service every vendor agrees to. Most of these defaults can be overridden at a more granular level later (per vendor, category, or product), so think of this page as setting the baseline that everything else builds on. To configure marketplace settings, navigate to Settings → Marketplace in the admin dashboard. The Marketplace settings page showing the commission rate, payouts, Shopify app, and terms of service sections

​
Vendor Commission Rate

This is the default percentage of each sale that your marketplace retains from a vendor’s revenue. It applies to all newly invited vendors and can be overridden later per vendor, per category-vendor pairing, or per individual product.
  • Commission Rate - the percentage taken from each sale. Used as the default for all newly invited vendors.
Changing this value only affects newly invited vendors. Existing vendors keep their current commission rate — to update an existing vendor’s rate, edit it from their vendor profile.

​
Vendor Payouts

This setting controls how frequently vendors can receive payouts through their Stripe dashboard. Vendors can choose to follow the marketplace default or set their own schedule from their vendor profile.
  • Preferred Vendor Payouts Schedule Interval - how often vendors are paid by default.
    • Daily
    • Weekly
    • Bi-weekly
    • Monthly
Changing this option also updates the payout schedule for any existing vendors whose schedule is set to Use marketplace default interval. Vendors who have a specific schedule set won’t be affected.

​
Shopify App

If your marketplace uses the Shopify integration to onboard Shopify vendors, this image is displayed to Shopify merchants when they install your app. A clear, branded image helps vendors recognize the marketplace they’re connecting to.
  • Upload New Media - the image shown on the Shopify install screen.
    • Recommended size: 600 × 300 pixels.
For more on the broader Shopify vendor onboarding flow, see Shopify Vendor Onboarding.

​
Vendor Terms of Service

The terms of service displayed to vendors when they accept their invitation to join the marketplace. Vendors must agree to these terms before they can complete onboarding. The editor supports rich formatting including headings, bold, italic, links, lists, quotes, and code blocks.
  • Vendor Terms of Service - the full terms vendors must agree to at invitation time.
Updating the terms doesn’t require existing vendors to re-accept — only vendors invited after the change will see the new version at sign-up.

​
Saving Changes

After making any updates, click Update at the bottom of the page to save your changes, otherwise any changes you’ve made will not be saved.