Pro plugin Version 1.2.1 Updated

Storefold - Multivendor Marketplace for WooCommerce documentation

Storefold Pro turns your WooCommerce store into a multivendor marketplace. Sellers apply, manage their own products and orders from a frontend dashboard, and you keep a commission on every sale.

Try the live demo Get Storefold

Overview

Storefold turns your WooCommerce shop into a marketplace. Sellers apply to open a store and wait for your approval. Once approved, they manage their own products and orders from a vendor dashboard on your site. Customers check out once, each seller receives only their part of the order, and you keep a commission.

Storefold Pro is a standalone plugin. It includes the complete free edition, so you don't need both. When you activate Pro while the free edition is active, the free edition is switched off automatically. Both editions use the same data, so your vendors, orders, commissions and settings carry over.

On top of the free edition, Pro adds commission rules per product, vendor and category. It also adds seller membership plans, Stripe Connect payouts, an earning hold period and several sellers per product. You also get staff accounts, identity verification, per-vendor shipping, customer disputes, an activity log, signed webhooks, CSV vendor import and an installable vendor dashboard with new order alerts.

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 Pro needs WooCommerce, so install and activate WooCommerce first. You don't need the free edition of Storefold. If the free edition is already active, Pro deactivates it automatically when you activate Pro, and all your data is kept.

  1. Install and activate WooCommerce if it is not active yet.

  2. Sign in to your ProPluginsLab account and go to My Account > Downloads. Download the Storefold Pro zip file.

  3. In WordPress, go to Plugins > Add New > Upload Plugin, choose the zip file and click Install Now.

  4. Click Activate Plugin. If the free edition of Storefold is active, it is switched off automatically and your data carries over.

  5. Open Storefold > Setup wizard to configure your marketplace. Every option can be changed later under Storefold > Settings.

License and automatic updates

Storefold works fully as soon as it is activated. The license key turns on automatic updates, so new versions arrive in WordPress like any other plugin update. Pro features never depend on it.

Activate your license

  1. Find your license key in My Account on propluginslab.io, in the license keys section. It is also in your order confirmation email.

  2. In WordPress, open Storefold > License. When two or more ProPluginsLab plugins or add-ons are active on the site, WooCommerce > Licenses also appears and lists all of them in one place.

  3. Paste the key into the Storefold - Multivendor Marketplace for WooCommerce Pro row and click Activate. The status changes to Active and automatic updates are on.

The license screen with a license key field, an Activate button and the license status
Storefold > License: paste the key and click Activate.

Receive updates automatically

Once the license is active, new versions of Storefold show up under Dashboard > Updates and on the Plugins screen. Click Update now, or click Enable auto-updates in the Storefold row on the Plugins screen and WordPress installs every future release for you.

Good to know

  • Keys are checked once a day in the background, so your site never waits for the license server. If the server is briefly unreachable, the plugin keeps its last known status.
  • An expired key or a key that is not accepted only stops updates. Storefold keeps working. After renewing, click Check now in its row.
  • Moving to a new domain: click Deactivate on the old site first, then activate the key on the new one. The status shows Site address changed, checking until the new address is confirmed.
  • On the command line: wp ppl-license list, wp ppl-license activate <plugin> <key>, wp ppl-license check and wp ppl-license deactivate <plugin>.

Quick start

  1. Run the setup wizard

    Go to Storefold > Setup wizard. You answer four questions: the kind of marketplace, 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. Add Become a Vendor and Stores to your site menu so people can find them.

  3. Review your commission and payout settings

    Open Storefold > Settings. Under Commission, check How do you take your cut? and your rate. Under Payouts, choose how vendors can get paid and set the Minimum withdrawal amount. Click Save settings.

  4. Invite your first seller

    Share your Become a Vendor page, or create a store yourself under Storefold > Vendors > Add a vendor. Approved sellers log in and open the Vendor Dashboard page.

  5. Watch the overview

    Go to Storefold > Overview. It shows this month's sales, your commission and what vendors earned, plus a Needs your attention list. The Marketplace health check flags setup problems and tells you how to fix each one.

#Marketplace overview

Storefold > Overview is your marketplace home screen.

  • Summary cards at the top: marketplace sales this month, what you earned in commission this month, what vendors earned after commission, and the number of active vendors (stores currently able to sell).
  • Needs your attention lists everything waiting on you, such as vendor applications and products waiting for review. When nothing is waiting, you see an "All clear" message.
  • Marketplace health runs checks on your setup and marks each one OK or Check. It covers the marketplace pages, pretty permalinks for store pages, vendor payout methods, marketplace emails, vendor accounts and vendor shipping. Every Check item comes with a short fix.
  • Quick links take you to the Become a Vendor page, the store directory, the vendor dashboard, the marketplace emails and the help pages.
Storefold Marketplace overview screen with summary cards, Needs your attention, Marketplace health checks and Quick links
The health list marks each check OK or Check. Here the Vendor shipping item needs attention.

#Vendors

Storefold > Vendors lists every store on your marketplace.

  • Filter the list by All, Pending, Approved, Suspended, Rejected or Verification pending, or type a name and click Search stores.
  • The table shows each store's Owner, Status, Balance, Verification, Commission and Joined date. Click View store to open the public store page.
  • Use the row buttons (Suspend, Reject, Delete), or tick several stores, choose a bulk action (Approve, Suspend, Reject or Delete) and click Apply.
  • Click a store name to see its balance, lifetime earnings, application answers and full money ledger. You can also rename the store there, or adjust the balance with a reason (for example a bonus or a fee charged outside the store).

Statuses: Pending means the seller applied and is waiting for you. Approved means they can sell. Suspended means their products can no longer be bought and their dashboard shows a notice, so use it for temporary problems. Rejected means the application was declined.

Add a vendor: open the Add a vendor panel and enter a Store name and Owner email. 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 can't be vendors, so use a separate account to test the vendor side.

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.

Vendors list with status filters, search, bulk actions and a table of stores with Suspend, Reject and Delete buttons
Use the status links above the table to find pending applications quickly.

#Commissions

Storefold > Commissions shows one row per sold item: the Item total the customer paid, what the Vendor keeps and what You keep.

  • Filter by vendor, by status (Pending, Earned or Reversed) and by a From and To date, then click Filter.
  • Click Export CSV to download the commission records.

Commission is calculated per sold item, on the item total after coupons, when the order is placed. The rule used is saved with each row, so later settings changes never rewrite history. Rows start as Pending and become Earned when the order reaches the status you chose under Vendors earn their money when in the settings. Refunds automatically take the matching amount back.

With Pro you can also set commission rules per product, per vendor and per product category.

Commissions table with vendor, status and date filters, an Export CSV button and columns for item total, vendor share and your share
Each row splits one sold item between the vendor and you.

#Withdrawals

Vendors ask to be paid on Storefold > Withdrawals. Send the money with the vendor's chosen method, then record the request as paid with a reference so everyone has a receipt.

  • Switch between Pending, Paid, Rejected and All requests.
  • Each row shows the Vendor, Amount, Method, Payout details, Requested date and Status.
  • To handle several requests at once, tick them, choose Mark as paid or Reject and click Apply to selected.

For PayPal, the vendor enters their PayPal email. For bank transfer, they enter the account holder, bank name, account number and routing number or IBAN. When Stripe payouts are enabled, marking a withdrawal as paid creates the transfer through Stripe.

Withdrawals screen with Pending, Paid, Rejected and All filters, a Mark as paid bulk action and the requests table
Choose Mark as paid or Reject, then apply it to the selected requests.

#Announcements

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

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

Published announcements are listed under Published, with their date and an action to manage them.

Announcements screen with a title field, a message box, a Publish announcement button and the Published list
Your announcement appears on every vendor's dashboard.

#Disputes

Storefold > Disputes collects problem reports from customers. Vendors can reply to each one.

Read both sides, then decide. You can refund the customer (the vendor earnings are reversed automatically) or side with the vendor. Filter the list by All, Open, Vendor replied, Refunded or Rejected.

Disputes screen with All, Open, Vendor replied, Refunded and Rejected filters
The Vendor replied filter shows disputes that are ready for your decision.

#Activity

Storefold > Activity is a log of everything that happens on the marketplace, newest first. It covers applications, approvals, products, orders, money, disputes and settings changes.

Each entry shows When, Who, the Event code (for example vendor.registered or order.split) and Details. To narrow the list, choose an event type (Vendors, Products, Offers, Orders, Withdrawals, Commissions, Disputes, Verification, Plans, Slot packs, Staff, Stripe or Settings) and click Filter.

Activity log table with When, Who, Event and Details columns and an event type filter
The order.split entries show a customer order being split into one sub-order per vendor.

#Import vendors

Storefold > Import vendors creates stores from a CSV file. It's useful when you move from another marketplace plugin (such as Dokan, WCFM, WC Vendors or MultiVendorX) or from a spreadsheet. Export your sellers to CSV and import them here.

  • Required columns: email, store_name.
  • Optional columns: phone, address, bio, website, paypal_email, status (approved or pending).
  • Click Download the sample CSV for a template.

To import:

  1. Click Choose File and select your CSV.
  2. Leave Email new accounts a password setup link ticked if new vendors should get a link to set their password.
  3. Click Preview only (no changes) for a dry run, and check the result.
  4. Click Import now.

Existing vendors are skipped, so you can safely run the same file twice. No financial data is touched.

Import vendors from CSV screen with the required columns, a file picker, the password setup link option and Preview and Import buttons
Run Preview only first to check the file without making changes.

#Marketplace settings

Storefold > Settings holds every marketplace option on one page. Each option has a short explanation and a Learn more link to the matching topic in Help and docs. Click Save settings at the bottom when you are done.

  • Vendor rules: choose whether you approve each new vendor application yourself or anyone who signs up can sell right away. You can also choose whether new vendor products go live immediately or wait for your review. Optionally, applicants must accept your seller terms page.
  • Commission: choose how you take your cut (a percentage, a fixed amount per item or both) and enter the numbers. A Live example shows what you and the vendor get on a sample sale. You also decide who receives shipping charges and taxes, and when vendors earn their money.
  • Payouts: tick the methods vendors can use (PayPal, Bank transfer, Stripe (automatic transfer)) and set the Minimum withdrawal amount. You approve every withdrawal.
  • Earning hold and Stripe payouts: hold new earnings for a number of days to cover your refund window, and enter your Stripe secret key for automatic transfers.
  • What vendors can sell: let vendors sell products that already exist in the catalog with their own price and stock. Under Categories open to vendors, tick categories to limit where vendors can list. Tick nothing to allow every category.
  • Vendor application form: the form already asks for store name, description, what they sell, contact details and address. Click Add a question to add your own questions. For each one, set the answer type, the choices for dropdowns (comma separated) and whether it's required. Answers appear on each application.
  • Seller plans: click Add a plan to create membership plans. Each plan has a name, price, billing, product limit, existing-product limit (0 means unlimited), your commission percentage and optional category restrictions. Under Extra product slots, you can let vendors on a limited plan buy packs of extra product slots.
  • Vendor shipping: click Add vendor shipping to all zones so vendor shipping rates are charged in your WooCommerce shipping zones.
  • Verification and vendor app: require verified vendors before their products can be bought, and let vendors install the dashboard on their phone with new order alerts.
  • Integrations: send marketplace events to a webhook URL, signed with a secret.
  • Storefront: show the store name across your shop, and limit store reviews to customers who bought from that store.
  • Marketplace pages: choose the page that holds each marketplace shortcode.
  • Data: decide whether marketplace data is deleted when you delete the plugin.
Marketplace settings page showing Vendor rules, Commission, Payouts, Earning hold and Stripe payouts, What vendors can sell and Vendor application form
The Live example under Commission updates as you type.

#Setup wizard

Storefold > Setup wizard gets you live with four quick questions: the kind of marketplace, your commission, how vendors get paid and how much you want to review.

The first step asks what kind of marketplace you are building:

  • 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.

Pick one and click Continue. You can change every answer later under Storefold > Settings.

Set up your marketplace wizard, step 1, with five marketplace types to choose from
The progress bar at the top shows the four steps of the wizard.

#Help and docs

Storefold > Help and docs explains every option in plain language, right inside WordPress. Use the Contents list to jump to a topic. The Learn more links on the settings screen take you straight to the matching entry.

Topics include getting started, each settings group, managing vendors, orders, commissions and refunds, withdrawals, the vendor dashboard, emails, shortcodes and store pages, security and privacy, and notes for developers. There are also sections for each Pro feature and a troubleshooting section.

Help and documentation screen with a contents list and topic panels such as Getting started and Settings: vendor rules
The contents list on the left links to every topic on the page.

#Marketplace emails

Storefold sends its notifications as WooCommerce emails. You manage them under WooCommerce > Settings > Emails, next to the standard WooCommerce emails. Their names start with Marketplace:.

  • Marketplace: new vendor application goes to the marketplace team when someone applies to become a vendor. It lists the application details and links to the full application, where you approve or reject it. Set who receives it under Recipient(s).
  • Marketplace: store approved goes to the vendor when you approve their store application. It links to their vendor dashboard and their public storefront.

Each email has the usual WooCommerce options: Enable/Disable, Subject, Email heading, Additional content, Email type, Cc(s) and Bcc(s). Use the Email preview to check the result, and click Send a test email to send yourself a copy. Click Save changes to keep your edits.

WooCommerce email settings for Marketplace: new vendor application with fields and an email preview
The preview shows the application details the marketplace team receives.
WooCommerce email settings for Marketplace: store approved with fields and an email preview
Approved vendors get a link to their dashboard and their store address.

Settings reference

Storefold > Settings

SettingTypeDefaultWhat it does
New vendor applications radio I review and approve each application (recommended) 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. The other choice, "Anyone who signs up can start selling right away", approves every applicant instantly.
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 them as Pending, and they appear under Products and in the "Needs your attention" list on the overview.
Applicants must accept the seller terms checkbox off Adds a required checkbox to the vendor application form that links to the page chosen under Seller terms. Applicants can't submit without ticking it.
Seller terms select Choose the page with your seller terms The page with your seller terms, linked from the application form checkbox.
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) or Percentage plus a fixed amount. Your cut is never more than the item price.
Your percentage number - The percentage you keep when your cut uses a percentage.
Your fixed amount per item number 0 The fixed amount you keep for every unit sold when your cut 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) Until then the commission stays "pending" and can't be withdrawn. The other choice is Payment is received (order is processing). Refunds automatically take the matching amount back.
PayPal checkbox - Lets vendors get paid by PayPal. They enter their PayPal email in their dashboard settings.
Bank transfer checkbox - Lets vendors get paid by bank transfer. They enter their bank account details in their dashboard settings.
Stripe (automatic transfer) checkbox off Pays vendors through Stripe Connect. Requires a Stripe secret key.
Minimum withdrawal amount number - Vendors can only request a payout once their available balance reaches this amount. This keeps transfer fees down.
Hold new earnings for number 0 A number of days. Earnings appear on the vendor balance at once but can only be withdrawn after this many days. Match it to your refund policy, for example 14. 0 releases them instantly.
Stripe secret key password - In your Stripe dashboard, enable Connect for a platform or marketplace. Then copy the secret key from Developers, API keys and paste it here. Also tick Stripe (automatic transfer). Vendors then click Connect with Stripe in their dashboard settings. The saved key is never shown again.
Let vendors sell products that already exist in the catalog, with their own price and stock checkbox off Product pages then show a "More sellers" box. Each sale goes to the seller the customer picked, and stock is tracked per seller.
Slots per pack number 0 The number of extra product slots in one pack. Set it to 0 to turn slot packs off.
Pack price number 0 The price of one slot pack. Vendors on a limited plan can buy more product slots without upgrading. Slots are a one-time purchase and stack on top of the plan limit. Set either field to 0 to turn this off.
Vendors must be verified before their products can be bought checkbox off Vendors upload an ID or business licence under Settings in their dashboard. Documents are stored privately, and only marketplace managers can open them. Verified stores always show a badge.
Let vendors install the dashboard on their phone and get new order alerts checkbox - Uses your site icon (Appearance, Customize, Site Identity). Alerts work while the dashboard is open, including as an installed app.
Webhook URL url - Marketplace events are sent to this address. Leave it empty to switch webhooks off. Addresses on your own network (localhost or private IPs) are refused.
Generate a new secret checkbox off Creates a new signing secret. Each request carries an X-Storefold-Signature header: the HMAC SHA-256 of the raw body with this secret. Compare it on your side to confirm the request came from your site.
Show the store name on product pages, shop listings, cart, checkout and orders checkbox - 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 must contain the [storefold_vendor_dashboard] shortcode.
Become a vendor select Become a Vendor The page must contain the [storefold_vendor_registration] shortcode.
Store directory select Stores The page must contain the [storefold_store_list] shortcode.
Delete all marketplace data when the plugin is deleted checkbox off When on, deleting the plugin removes the marketplace tables, settings, the vendor role and the three pages. 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. When empty, the placeholder shown is used: `[{site_title}] New vendor application: {store_name}`.
Email heading text - The main heading in the email. When empty, the placeholder shown is used: `New vendor application`.
Additional content textarea - Extra text shown below the main email content.
Email type select HTML Plain text, HTML or Multipart.
Cc(s) text - Extra addresses that receive a copy.
Bcc(s) text - Extra addresses that receive a hidden copy.
Recipient(s) text - Who receives new vendor application emails.

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. When empty, the placeholder shown is used: `Your store {store_name} is approved`.
Email heading text - The main heading in the email. When empty, the placeholder shown is used: `Welcome aboard!`.
Additional content textarea - Extra text shown below the main email content.
Email type select HTML Plain text, HTML or Multipart.
Cc(s) text - Extra addresses that receive a copy.
Bcc(s) text - Extra addresses that receive a hidden copy.

Shortcodes

[storefold_vendor_dashboard]

Shows the frontend vendor dashboard where approved sellers manage their store. Select the page that holds it under Storefold > Settings > Marketplace pages > Vendor dashboard.

[storefold_vendor_dashboard]

[storefold_vendor_registration]

Shows the vendor application form. Select the page that holds it under Storefold > Settings > Marketplace pages > Become a vendor.

[storefold_vendor_registration]

[storefold_store_list]

Shows the store directory with a store search. Select the page that holds it under Storefold > Settings > Marketplace pages > Store directory.

[storefold_store_list]

On your site

Storefold adds a few things shoppers and sellers see on your site.

  • Stores page: the store directory lists every store as a card, with a Search stores box. Clicking a store opens its store page. Individual stores live at /store/store-name/ on your site, which needs pretty permalinks.
  • Become a Vendor page: the application form where sellers apply to open a store. If you enabled seller terms or added your own questions, they appear here.
  • Vendor Dashboard page: where approved sellers manage their store, products and orders, see your announcements and request withdrawals.
  • "Sold by" labels: when enabled, "Sold by Store name" appears under the product title. Shop listings show a small "by Store name", and the cart, checkout, account area and emails show a "Sold by" line on order lines.
  • Store reviews: customers can rate a store from its store page.
  • More sellers box: when vendors may sell products that already exist in the catalog, product pages show a "More sellers" box so customers can pick a seller.
Stores directory page with a Search stores box and a card for each store
Each card links to that seller's store page.

Frequently asked questions

Do I need the free edition of Storefold as well?

No. Pro contains everything in the free edition. You can delete the free edition after activating Pro.

Will I lose data when I switch from the free edition to Pro?

No. Both editions share the same tables and settings, so every vendor, order, commission and setting carries over. When you activate Pro, the free edition is switched off automatically.

What happens to marketplace data when I delete the plugin?

Nothing, unless you ticked Delete all marketplace data when the plugin is deleted under Storefold > Settings > Data. Data is also always kept while another Storefold edition is still installed.

How is my commission calculated?

Commission is calculated per sold item, on the item total after coupons, when the order is placed. You choose a percentage, a fixed amount per item or both under Storefold > Settings > Commission. Your cut is never more than the item price, and commission is never taken from shipping or tax. Pro also supports commission rules per product, per vendor and per product category.

When can vendors withdraw their earnings?

Commissions stay Pending until the order reaches the status set under Vendors earn their money when. If you set Hold new earnings for, earnings can only be withdrawn after that many days. The vendor's available balance must also reach the Minimum withdrawal amount.

Can I pay vendors automatically?

Yes, with Stripe Connect. Enter your Stripe secret key under Storefold > Settings > Earning hold and Stripe payouts and tick Stripe (automatic transfer) under Payouts. Vendors then click Connect with Stripe in their dashboard settings. Stripe transfers are created for withdrawals you mark as paid.

Can I move my sellers from another marketplace plugin?

Yes. Export your sellers to CSV and import them under Storefold > Import vendors. The file needs email and store_name columns. Existing vendors are skipped, and nothing financial is touched.

Does Storefold send data to outside services?

Only when you use the matching feature. With Stripe payouts enabled, the plugin talks to the Stripe API, and vendors complete onboarding at Stripe (https://stripe.com/privacy). When you enter a webhook URL, marketplace events are sent to that address. No other data leaves your site.

Troubleshooting

The overview shows "Check" next to Vendor shipping

Vendor shipping isn't in any shipping zone, so vendor rates aren't charged. Go to Storefold > Settings > Vendor shipping and click Add vendor shipping to all zones, then Save settings.

Store pages return a "page not found" error

Store pages live at /store/store-name/ and need pretty permalinks. Under Settings > Permalinks in WordPress, choose any structure other than Plain and save. Then check Marketplace health on Storefold > Overview.

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

Each page must contain its shortcode: [storefold_vendor_dashboard], [storefold_vendor_registration] or [storefold_store_list]. Under Storefold > Settings > Marketplace pages, check that each role points to the page that holds the matching shortcode.

I can't open a store with my administrator account

Administrators and shop managers can't be vendors, because every product their account creates would count as that store's. To test the vendor side, apply with a separate account. The Vendor accounts health check on the overview warns you if an older store is linked to a manager account.

A vendor can't request a withdrawal

Check these three things:

  • Their commissions may still be Pending. They become Earned when the order reaches the status set under Vendors earn their money when.
  • Hold new earnings for may still be holding the earnings.
  • Their available balance may be below the Minimum withdrawal amount. Also check that at least one payout method is ticked under Payouts.
My webhook URL is not accepted

For safety, addresses on your own network (localhost or private IPs) are refused. Use a public URL from the receiving service, such as Zapier, Make, n8n or your own system.