docs/user/vendors/vendor-onboarding-woocommerce.mdx
<Warning>WooCommerce vendor onboarding is only available in Spree Enterprise Edition.</Warning>
<Note>This guide covers vendors who'll connect their WooCommerce store to your marketplace. For other vendor types, see <u>Shopify Vendor Onboarding</u> and <u>Manual/CSV Vendor Onboarding</u>.</Note>
WooCommerce is one of the most widely used ecommerce platforms in the world, so it's worth making it easy for WooCommerce-based vendors to join your marketplace. Once connected, a vendor's products, inventory, orders, and shipping flow automatically between their WooCommerce store and your marketplace — no manual reconciliation required.
Onboarding a WooCommerce vendor has two distinct parts: an Admin Setup that the marketplace owner completes by sending an invitation, and a Vendor Onboarding flow that the vendor themselves completes after receiving the invite.
Before you can onboard WooCommerce vendors, you'll need:
spree_multi_vendor Enterprise gem installed on your Spree instance.This section is for the marketplace owner. Inviting a WooCommerce vendor uses the same invitation flow as Manual/CSV vendors — the vendor chooses WooCommerce as their connection method during their own onboarding.
To invite a vendor, navigate to Vendors in the admin dashboard.
Click Invite Vendor in the top right corner to open the invitation form.
Fill in the following fields:
<Note>The commission rate can be different for each vendor and updated later from the vendor's profile.</Note>
Double-check the details and click Send Invitation. The newly invited vendor will appear in your list of vendors with a pending status.
The vendor will receive an email at the specified address with a link to begin onboarding.
If the vendor doesn't receive the email, or they prefer a different communication channel, you can copy the invitation link and send it directly.
Click on the vendor in the list to open their vendor profile, navigate to the Invitations subtab, click the three-dot menu, and select Copy invitation link.
If you need to withdraw the invitation — whether the wrong contact was invited, the vendor's details need correcting, or the partnership ended before they began onboarding — navigate to the Invitations subtab as above, click the three-dot menu, and select Delete.
<Warning>Cancelling an invitation is irreversible. To re-invite the vendor later, you'll need to start the invitation flow from scratch.</Warning>
This section is for the vendor. Once you've received the invitation from the marketplace owner, follow these steps to connect your WooCommerce store and complete your onboarding.
You'll receive an email invitation from the marketplace owner with a link to get started. Click the link to be directed to your vendor account creation page.
Fill in the sign-up form to create your vendor account, then click Create Account.
You'll then be redirected to your new vendor dashboard, where you'll see a Getting Started checklist of onboarding tasks.
Click on the Connect or Create a Shop task in the checklist, then click WooCommerce.
A popup will appear asking for your WooCommerce store's URL.
Enter your store URL and click Continue. You'll be redirected to a page asking you to approve the marketplace's connection to your store.
Click Approve. You'll be redirected back to your vendor dashboard, and the task will be marked complete.
A few minutes after connecting, your WooCommerce products will start appearing in your Spree vendor dashboard.
With your store connected, you'll still need to complete a few more tasks before you can start selling.
Your company's billing address is needed for vendor payouts and invoices. Click on the task in your checklist, fill in the form, and click Save.
Stripe is used by the marketplace to process payments and send your payouts. To receive your earnings, you'll need to connect a Stripe account.
An existing Stripe account isn't required — you can create one as part of this flow. The whole process usually takes around five minutes. Once connected, you'll receive payouts whenever you ship orders.
<Note>If you're not the one handling your company's financials, you can invite another team member to complete this step instead.</Note>
<Warning>Some marketplaces use payment providers other than Stripe. If that's the case, you'll be prompted to connect your bank account through a different flow — your marketplace owner will let you know the specifics.</Warning>
A returns address ensures customers know where to send returns. Click on the task in your checklist, enter your company's return address, and click Save.
Your WooCommerce shipping methods are synced to the marketplace automatically, but rates aren't — you'll need to set them manually.
Click on the Set Shipping Rates task, then click Manage Shipping Rates to be taken to the Settings → Shipping section of your vendor dashboard. Set the rate for each shipping method, then click Confirm Shipping Rates in the top right corner.
<Note>You can edit existing shipping methods or add new ones at any time after onboarding is complete.</Note>
Clear policies build customer trust, sets clear expectations, and helps prevent disputes over shipping, returns and refunds.
Once your WooCommerce store is connected, the following data syncs automatically:
Once onboarding is complete, your products will be sent to the marketplace owner for review. Once they're approved, they'll go live on the storefront, and you can manage your business primarily from your WooCommerce dashboard.
For other vendor types, see <u>Shopify Vendor Onboarding</u> or <u>Manual/CSV Vendor Onboarding</u>.