Free plugin Version 1.1.0 Updated

Storefold - Multivendor Marketplace for WooCommerce Free documentation

Storefold turns your WooCommerce store into a multivendor marketplace. Sellers apply, you approve them, and they manage their own products, orders and payouts from a vendor dashboard on the front of your site while you keep a commission.

Try the live demo Get Pro

Overview

Storefold lets other sellers open their own store inside your WooCommerce shop. Sellers apply through a form on your site, you approve them, and they manage their products and orders from a vendor dashboard on the front of your site. Vendors never see wp-admin.

Customers check out once and see one order. In the background, Storefold creates one sub-order per vendor with that vendor's share of shipping. Each vendor receives only their part of the order, and you keep a commission as a percentage, a fixed amount per item, or both.

You manage everything under the Storefold menu in wp-admin: vendors, commissions, withdrawal requests, announcements to vendors and the marketplace settings. A setup wizard and a built-in Help and docs screen explain each option. The plugin is compatible with High-Performance Order Storage (HPOS) and the Cart and Checkout blocks, and it does not connect to any external service.

Requirements

  • WordPress 6.4 or later (tested up to 7.1)
  • PHP 7.4 or later
  • WooCommerce 8.5 or later, installed and active

Installation

Storefold is a free plugin on WordPress.org. It needs WooCommerce, so install and activate WooCommerce first.

  1. Make sure WooCommerce is installed and active.

  2. In wp-admin, go to Plugins > Add New.

  3. Search for Storefold Multivendor Marketplace.

  4. Click Install Now on the Storefold plugin, then click Activate.

  5. After activation, a notice on the Plugins screen offers the setup wizard. You can also open it any time under Storefold > Setup wizard.

  6. Add the Become a Vendor and Stores pages to your site menu so sellers and shoppers can find them.

Quick start

  1. Run the setup wizard

    Go to Storefold > Setup wizard. It asks four questions: the kind of marketplace you are building, your commission, how vendors get paid, and how much you want to review. Everything can be changed later under Storefold > Settings.

  2. Check the marketplace pages

    Activation creates three pages: Vendor Dashboard, Become a Vendor and Stores. Open Storefold > Overview and look at Marketplace health. The Marketplace pages check should say the pages are published.

  3. Enable a payout method

    Under Storefold > Settings > Payouts, tick PayPal, Bank transfer or both, and set the Minimum withdrawal amount. Click Save settings.

  4. Link Become a Vendor in your menu

    Add the Become a Vendor and Stores pages to your site menu under Appearance > Menus (or the Site Editor), so sellers can find the application form.

  5. Approve your first vendor

    When someone applies, you get the Marketplace: new vendor application email. Approve the application under Storefold > Vendors, or add a vendor yourself with Add a vendor. The vendor then logs in and opens the Vendor Dashboard page.

#Marketplace overview

Storefold > Overview is your marketplace home screen.

  • Summary cards show marketplace sales this month (everything customers spent on vendor products), what you earned this month (your commission), what vendors earned this month after commission, and the number of active vendors.
  • Getting started is a five-step checklist: run the setup wizard, check the marketplace pages, enable a payout method, link "Become a Vendor" in your menu, and approve your first vendor. Click Hide this checklist once you are done.
  • Needs your attention lists everything waiting on you, such as vendor applications and products waiting for review.
  • Marketplace health runs checks with a plain fix for each problem: marketplace pages, pretty permalinks, vendor payouts, marketplace emails and vendor accounts.
  • Quick links take you to the Become a Vendor page, the store directory, the vendor dashboard, the marketplace emails and the help screen.

A banner about Storefold Pro appears at the top of Storefold admin screens. You can dismiss it with the close button.

Storefold Marketplace overview screen with four summary cards, the Getting started checklist, Needs your attention, Marketplace health and Quick links
The Getting started checklist tracks setup progress, and each Marketplace health check shows OK when that part is set up correctly.

#Vendors

Storefold > Vendors lists every store with its Store, Owner, Status, Balance, Joined date and Actions.

Statuses

  • Pending: the seller applied and is waiting for you.
  • Approved: the vendor can sell.
  • Suspended: their products can no longer be bought and their dashboard shows a notice. Use it for temporary problems.
  • Rejected: the application was declined.

Use the status links above the table to filter the list, and Search stores to find a store by name.

Add a vendor yourself

  1. Click Add a vendor.
  2. Enter the Store name and the Owner email.
  3. Save. If an account with that email exists, it becomes the owner. Otherwise a new account is created and emailed a link to set a password.

Administrators and shop managers cannot be vendors, because every product their account creates would count as that store's products. To try the vendor side, apply with a separate account.

Bulk actions

Tick several vendors, choose Approve, Suspend, Reject or Delete under Bulk actions, and click Apply.

Deleting a vendor removes the store and the vendor role and cancels open withdrawal requests. The user account, their products, and all commission and ledger history are kept, because they are financial records.

Storefold Vendors screen with the Add a vendor panel, status filters, a Search stores box, Bulk actions and the vendor table
Filter by Pending, Approved, Suspended or Rejected, and open Add a vendor to create a store yourself.

#Commissions

Storefold > Commissions shows one row per sold item: what the customer paid, what the vendor keeps and what you keep. The columns are Order, Vendor, Product, Item total, Vendor keeps, You keep, Status and Date.

Commission rows start as Pending. They become Earned when the vendor order reaches the status you chose under Vendors earn their money when in the settings, and the vendor balance goes up. When you refund an order, the matching earning is Reversed automatically.

To narrow the list:

  1. Pick a vendor (or keep All vendors).
  2. Pick a status: Any status, Pending, Earned or Reversed.
  3. Optionally set a From and To date.
  4. Click Filter.

Click Export CSV to download the commissions as a CSV file.

Storefold Commissions screen with vendor, status and date filters, an Export CSV button and the commissions table
Each row is one sold item, split into what the vendor keeps and what you keep.

#Withdrawals

Vendors request payouts from their dashboard, and the requests appear under Storefold > Withdrawals. The table shows the Vendor, Amount, Method, Payout details, Requested date, Status and Action.

You send the money yourself:

  1. Open the Pending tab.
  2. Send the amount to the vendor with the method they chose (PayPal or bank transfer), using the payout details shown.
  3. Record the request as paid with a reference, so everyone has a receipt.

To handle several requests at once, tick them, choose Mark as paid or Reject, and click Apply to selected. The Paid, Rejected and All tabs show earlier requests.

Vendors can only request a payout once their available balance reaches the Minimum withdrawal amount from the settings.

Storefold Withdrawals screen with Pending, Paid, Rejected and All tabs, a Mark as paid bulk action and the withdrawal requests table
Use Mark as paid or Reject with Apply to selected to process several requests at once.

#Announcements

Use Storefold > Announcements to post a message to every vendor. Vendors see it on their dashboard.

  1. Enter a Title.
  2. Write the message in Write your message to vendors.
  3. Click Publish announcement.

Published announcements are listed under Published with their Title, Date and an Action column.

Storefold Announcements screen with a Title field, a message box, the Publish announcement button and the Published list
Every vendor sees published announcements on their dashboard.

#Settings

Storefold > Settings holds all marketplace options, grouped in six boxes. Each option has a short explanation and a Learn more link to the matching entry in Help and docs. Click Save settings when you are done.

  • Vendor rules: whether you approve each new vendor or anyone can start selling right away, whether new vendor products go live immediately or wait for your review, and an optional seller terms checkbox on the application form.
  • Commission: how you take your cut (percentage, fixed amount per item, or both), your percentage and fixed amount, and who gets shipping and tax. A Live example line shows what you and the vendor get on a sample sale while you type.
  • Payouts: the payout methods vendors can choose (PayPal, Bank transfer) and the Minimum withdrawal amount.
  • Storefront: "Sold by" labels and who can review a store.
  • Marketplace pages: which pages hold the vendor dashboard, the application form and the store directory.
  • Data: whether deleting the plugin also deletes marketplace data.

Commission is calculated per sold item, on the item total after coupons, when the order is placed. The rule used is saved with each commission row, so later changes never rewrite history. Commission is never taken from shipping or tax.

See the settings reference below for every field.

Storefold Marketplace settings screen with the Vendor rules, Commission, Payouts, Storefront, Marketplace pages and Data boxes
The Live example under Commission updates as you change your percentage or fixed amount.

#Setup wizard

Storefold > Setup wizard asks four quick questions: the kind of marketplace, your commission, how vendors get paid, and how much you want to review. Your answers fill in the settings, and you can change every answer later under Storefold > Settings.

The first question is What kind of marketplace are you building? Choose one:

  • Physical products: makers and resellers shipping goods.
  • Digital downloads: files, templates and software. Earnings release as soon as payment clears.
  • Services and bookings: local pros and freelancers selling their time.
  • Local multi-store: a city marketplace with pickup and delivery.
  • Wholesale or B2B: businesses selling to businesses in bulk.

Click Continue to move to the next question.

Storefold setup wizard showing step 1, What kind of marketplace are you building, with five marketplace types and a Continue button
The progress bar at the top shows which of the four questions you are on.

#Help and docs

Storefold > Help and docs explains everything you can configure, in plain language. Use the Contents list to jump to a topic:

  1. Getting started
  2. Settings: vendor rules
  3. Settings: commission
  4. Settings: payouts
  5. Settings: storefront, pages and data
  6. Managing vendors
  7. Orders, commissions and refunds
  8. Withdrawals
  9. The vendor dashboard
  10. Emails
  11. Shortcodes and store pages
  12. Security and privacy
  13. For developers
  14. Troubleshooting

The Learn more links on the settings screen bring you straight to the matching entry here.

Storefold Help and documentation screen with a Contents list on the left and topic cards such as Getting started and Settings: vendor rules
Each settings option has its own entry, and the contents list jumps straight to it.

#Marketplace emails

Storefold registers five marketplace emails as WooCommerce emails. You edit them under WooCommerce > Settings > Emails, like any other WooCommerce email. Each one has an editable subject, heading and body text with placeholders such as {site_title} and {store_name}, and a preview.

Two examples:

  • Marketplace: new vendor application is sent to the marketplace team when someone applies to become a vendor. It lists the applicant's answers and links to the full application so you can approve or reject it. Set who receives it in Recipient(s).
  • Marketplace: store approved is sent to a vendor when their store application is approved. It links to their vendor dashboard and their public storefront.

For each email you can:

  1. Turn it on or off with Enable/Disable.
  2. Change the Subject, Email heading and Additional content. The fields show the default text as a placeholder.
  3. Choose the Email type: Plain text, HTML or Multipart.
  4. Add Cc(s) and Bcc(s) addresses.
  5. Check the Email preview on desktop or mobile, or click Send a test email.
  6. Click Save changes.
WooCommerce email settings for Marketplace: new vendor application, with Subject, Email heading, Recipient(s) and an email preview
The preview shows the applicant's details and a link to review the full application.
WooCommerce email settings for Marketplace: store approved, with editable fields and a preview of the Welcome aboard email
The approval email walks the new vendor through their first steps and links to their storefront.

Settings reference

Storefold > Settings

SettingTypeDefaultWhat it does
New vendor applications radio I review and approve each application (recommended) Choose **I review and approve each application (recommended)** or **Anyone who signs up can start selling right away**. With manual approval, new sellers wait on a pending screen until you approve them under Storefold > Vendors, and they get an email when you do.
New vendor products radio Go live immediately **Go live immediately** publishes products as soon as the vendor saves them. **Wait for my review before going live** saves new products as Pending; they appear under Products with the Pending status and in the Needs your attention list on the overview. Edits to already published products stay live.
Applicants must accept the seller terms checkbox off Adds a required checkbox with a link to your seller terms page to the vendor application form. Applicants cannot submit without ticking it.
Seller terms select - The page with your seller terms, linked from the checkbox on the vendor application form.
How do you take your cut? select Percentage of the sale **Percentage of the sale**: a share of the item price after discounts. **Fixed amount per item**: the same amount for every unit sold. **Percentage plus a fixed amount**: both. Your cut is never more than the item price.
Your percentage number - The percentage you keep when the rule uses a percentage.
Your fixed amount per item number - The amount you keep per unit sold when the rule uses a fixed amount.
Shipping charges go to select - **The vendor (they ship the products)** or **Me, the marketplace owner**. Commission is never taken from shipping. When shipping goes to the vendor, their share of the order shipping is added to their earnings.
Taxes go to select - Choose **Me, the marketplace owner** when the marketplace files the sales tax. Choose **The vendor** when each seller is responsible for their own tax; their share of the order tax is then added to their earnings.
Vendors earn their money when select The order is completed (recommended) **The order is completed (recommended)** or **Payment is received (order is processing)**. Until then the commission stays pending and cannot be withdrawn. Refunds automatically take the matching amount back.
PayPal checkbox - Lets vendors choose PayPal as their payout method and enter their PayPal email in their dashboard settings.
Bank transfer checkbox - Lets vendors choose bank transfer and enter their account holder, bank name, account number and routing or IBAN.
Minimum withdrawal amount number - Vendors can only request a payout once their available balance reaches this amount. Keeps transfer fees down.
Show the store name on product pages, shop listings, cart, checkout and orders checkbox on Shows "Sold by" labels so shoppers see who they buy from and can click through to the store page.
Only customers who bought from a store can review it checkbox off Recommended once you have real orders. It stops fake reviews from people who never bought anything.
Vendor dashboard select Vendor Dashboard The page used as the vendor dashboard. It must contain the `[storefold_vendor_dashboard]` shortcode.
Become a vendor select Become a Vendor The page with the vendor application form. It must contain the `[storefold_vendor_registration]` shortcode.
Store directory select Stores The page that lists all stores. It must contain the `[storefold_store_list]` shortcode.
Delete all marketplace data when the plugin is deleted checkbox off Off keeps every table and setting, so reinstalling brings everything back. On removes the marketplace tables, settings, the vendor role and the three pages when you delete the plugin. Commissions and payouts are financial records, so leave this off unless you are sure. Data is always kept while another Storefold edition is installed.

WooCommerce > Settings > Emails > Marketplace: new vendor application

SettingTypeDefaultWhat it does
Enable/Disable checkbox on Sends this email to the marketplace team when someone applies to become a vendor.
Subject text - The email subject. The field shows the default `[{site_title}] New vendor application: {store_name}` as a placeholder.
Email heading text - The heading at the top of the email. The placeholder shows the default `New vendor application`.
Additional content textarea - Extra text added to the email.
Email type select HTML The email format: **Plain text**, **HTML** or **Multipart**.
Cc(s) text - Addresses that receive a copy.
Bcc(s) text - Addresses that receive a blind copy.
Recipient(s) text - Who receives the new vendor application email.

WooCommerce > Settings > Emails > Marketplace: store approved

SettingTypeDefaultWhat it does
Enable/Disable checkbox on Sends this email to a vendor when their store application is approved.
Subject text - The email subject. The placeholder shows the default `Your store {store_name} is approved`.
Email heading text - The heading at the top of the email. The placeholder shows the default `Welcome aboard!`.
Additional content textarea - Extra text added to the email.
Email type select HTML The email format: **Plain text**, **HTML** or **Multipart**.
Cc(s) text - Addresses that receive a copy.
Bcc(s) text - Addresses that receive a blind copy.

Shortcodes

[storefold_vendor_dashboard]

Shows the frontend vendor dashboard where vendors manage their products, orders, coupons, earnings, payouts, announcements and settings. The page set as **Vendor dashboard** under Storefold > Settings > Marketplace pages must contain it.

[storefold_vendor_dashboard]

[storefold_vendor_registration]

Shows the step-by-step vendor application form, which creates the account at the same time. The page set as **Become a vendor** under Storefold > Settings > Marketplace pages must contain it.

[storefold_vendor_registration]

[storefold_store_list]

Shows the store directory with a search box. The page set as **Store directory** under Storefold > Settings > Marketplace pages must contain it.

[storefold_store_list]

On your site

Storefold adds these pages and elements to the front of your site:

  • Store directory: the page with [storefold_store_list] lists your stores with a Search stores box. When nothing matches, shoppers see "No stores found. Try a different search."
  • Become a vendor: visitors without a store see a Want to sell here? box with a Become a vendor button that leads to the application form.
  • Store pages: each vendor gets a store page at /store/store-name/ with banner, logo, policies, products and reviews. These pages need pretty permalinks.
  • "Sold by" labels: when enabled, product pages, shop listings, cart, checkout (classic and block) and orders show the store name, so shoppers can click through to the store.
  • Vendor dashboard: approved vendors manage their products, orders, coupons, earnings, payouts, announcements and settings from the Vendor Dashboard page. Vendors can also switch on vacation mode with a custom message.

If you are logged in as an administrator or shop manager, you see a You manage this marketplace note instead of the application prompt. These accounts cannot open a store. To try the vendor side, log out and apply with a separate account.

Store directory page with a Search stores box, a Want to sell here? box with a Become a vendor button, and a You manage this marketplace note
Shoppers can search stores, and visitors without a store are invited to apply.

Frequently asked questions

Does the customer see several orders?

No. The customer pays once and sees one order. Vendor sub-orders are created in the background and hidden from the customer account.

How does a vendor get paid?

The vendor requests a withdrawal from their dashboard. You send the money by PayPal or bank transfer and mark the request as paid under Storefold > Withdrawals.

What happens on a refund?

Refund from the vendor order in WooCommerce as usual. The vendor earning for the refunded items is reversed in their ledger automatically.

Can vendors use wp-admin?

No. Vendors work from the Vendor Dashboard page on the front of the site, and they only see their own media uploads.

Where do I edit the marketplace emails?

Under WooCommerce > Settings > Emails. Each marketplace email has an editable subject, heading and body text with placeholders.

Can I change the look of the vendor pages?

Yes. Copy any file from the plugin templates folder to yourtheme/storefold/ and edit the copy.

Is it compatible with High-Performance Order Storage?

Yes. All order access uses the WooCommerce CRUD layer. Storefold also works with the Cart and Checkout blocks.

Can vendors export their sales?

Yes. On the Vendor Dashboard Earnings screen, vendors can download a CSV file of their own sales and earnings, for all time or for a date range. It only ever contains that vendor's rows.

Troubleshooting

Store pages at /store/store-name/ do not load

Store pages need pretty permalinks. Go to Settings > Permalinks, choose any option other than Plain and save. The Pretty permalinks check under Marketplace health on Storefold > Overview should then show OK.

The vendor dashboard, application form or store directory page is empty or missing

Open Storefold > Settings > Marketplace pages and check that each option points to a published page. The pages must contain [storefold_vendor_dashboard], [storefold_vendor_registration] and [storefold_store_list]. The Marketplace pages health check on the overview tells you when a page is missing.

I cannot open a store with my administrator account

This is intended. Administrators and shop managers cannot be vendors, because every product their account creates would count as that store's products. Log out and apply with a separate account. The Vendor accounts health check warns you if an older store is linked to a manager account.

A vendor cannot request a withdrawal

Check two things under Storefold > Settings:

  • Earnings stay pending until the order reaches the status set in Vendors earn their money when. Pending earnings cannot be withdrawn.
  • The vendor's available balance must reach the Minimum withdrawal amount.

Also make sure at least one payout method (PayPal or Bank transfer) is ticked.

New vendor products do not appear in the shop

If New vendor products is set to Wait for my review before going live, new products are saved with the Pending status. Find them under Products or in Needs your attention on the overview and publish them.

You are not receiving new vendor application emails

Go to WooCommerce > Settings > Emails > Marketplace: new vendor application. Make sure Enable/Disable is ticked and that Recipient(s) holds the right address, then click Send a test email to check delivery.

Upgrade

Upgrade to Storefold - Multivendor Marketplace for WooCommerce

This free edition is complete on its own. Storefold Pro is a separate, standalone edition for larger marketplaces. It contains everything in the free edition and adds more tools. Activating Pro switches the free edition off and keeps all your data.

  • Disputes: customers open a case, you rule and refund
  • Automatic vendor payouts with Stripe Connect
  • Seller membership plans, free or paid, with product limits
  • Staff accounts for vendors with limited permissions
  • Offers: several vendors can sell the same product
  • Activity log and CSV vendor import

Try the Pro demo Get Pro