Pro plugin Version 1.4.0 Updated

Storefold - Multivendor Marketplace for WooCommerce documentation

Storefold turns your WooCommerce shop into a multivendor marketplace. Sellers apply, list products and manage their orders from a dashboard on your site, you keep a commission, and refunds, disputes and payouts are handled in one place.

Try the live demo Get Storefold

Overview

Storefold turns your WooCommerce shop into a marketplace. Sellers apply to open a store, you approve them, and they manage their own products, orders, coupons and payouts from a Vendor Dashboard page on the front of your site. Vendors never see wp-admin.

Customers check out once. Behind the scenes every vendor gets their own vendor order with only their items, their share of shipping and their tax, and you keep a commission on each sale. Refunds made on the customer's order are copied to the vendor orders they cover and taken from each vendor's earnings.

The Pro edition is a standalone plugin that contains everything in the free edition, plus vendor reports, refund and return requests, customer to seller messaging, per-vendor shipping zones, automatic payouts, commission rules per product, vendor and category, seller plans, Stripe Connect payouts, earning holds, several sellers per product, staff accounts, identity verification, disputes, an activity log, webhooks and CSV vendor import.

Requirements

  • WordPress 6.4 or later (tested up to 7.1)
  • PHP 7.4 or later
  • WooCommerce 8.5 or later (required, must be installed and active)
  • The free edition of Storefold is not needed: Pro contains everything

Installation

Storefold Pro needs WooCommerce. Install and activate WooCommerce first. You do not need the free edition of Storefold: Pro contains everything. If the free edition is already active, it stays idle when Pro is active and shows a notice on the Plugins screen so you can deactivate it yourself. Both editions use the same data, so every vendor, order, commission and setting carries over.

  1. Make sure WooCommerce is installed and active.

  2. Log in to your ProPluginsLab account and open 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. Activation creates three pages: Vendor Dashboard, Become a Vendor and Stores.

  5. If the free edition of Storefold is active, deactivate it on the Plugins screen. Your data is kept.

  6. Open Storefold > Setup wizard to answer the four setup questions, then fine tune everything 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

    Open Storefold > Setup wizard. Choose the kind of marketplace, your commission, how vendors get paid and how much you want to review. Click Finish and open my marketplace. You can change every answer later under Storefold > Settings.

  2. Check the marketplace pages and menu

    Activation creates the Vendor Dashboard, Become a Vendor and Stores pages. Add Become a Vendor and Stores to your site menu so people can find them. Open Storefold > Overview and check that the Marketplace health list shows OK for the pages and permalinks.

  3. Switch on vendor shipping

    Go to Storefold > Settings, section Vendor shipping, and click Add vendor shipping to all zones. Until you do, vendors can save rates but they are not charged at checkout.

  4. Add your first vendor

    Share the Become a Vendor page, or open Storefold > Vendors, expand Add a vendor, enter a store name and owner email, and click Create approved vendor. Applications waiting for you appear under Needs your attention on the overview.

  5. Let the vendor add products

    The vendor logs in and opens the Vendor Dashboard page. The setup checklist walks them through their logo, store description, first product and payout method.

  6. Follow the money

    When an order comes in, check Storefold > Commissions to see what the vendor keeps and what you keep. When vendors ask to be paid, their requests appear under Storefold > Withdrawals.

#Marketplace overview

Storefold > Overview is your home screen for the marketplace.

  • The cards at the top show Marketplace sales this month, You earned this month (your commission), Vendors earned this month and Active vendors (stores currently able to sell).
  • Needs your attention lists everything waiting on you, with a link to each: vendor applications, products waiting for review, disputes waiting for a verdict, approved refund requests waiting for you to refund, and verification documents waiting for review.
  • Marketplace health checks your setup and marks each item OK or Check, with a plain fix. It checks the marketplace pages, pretty permalinks, payout methods, marketplace emails, vendor accounts linked to an administrator or shop manager, vendor shipping, Stripe payouts (when Stripe is enabled) and plan renewals (when seller plans exist).
  • Quick links open the Become a Vendor page, the store directory, the vendor dashboard, the marketplace emails and the built-in help.
Marketplace overview screen with sales cards, a Needs your attention list, the Marketplace health checks and Quick links
Items marked Check in Marketplace health tell you exactly what to fix.

#Vendors

Storefold > Vendors lists every store with its owner, status, balance, verification state, commission rule and join date.

Statuses

  • Pending: applied, waiting for you.
  • Approved: can sell.
  • Suspended: products can no longer be bought and the dashboard shows a notice. Use it for temporary problems.
  • Rejected: application declined.
  • Verification pending lists stores whose identity document waits for review.

Add a vendor yourself

  1. Click Add a vendor.
  2. Enter the Store name and Owner email.
  3. Click Create approved vendor. An existing account with that email becomes the owner; otherwise a new account is created and emailed a link to set a password.

Administrators and shop managers cannot be vendors. To test the vendor side, apply with a separate account.

Approve, suspend, reject or delete

Use the buttons in the Actions column, or tick several stores, pick an action under Bulk actions and click Apply. When you reject or suspend you can type a reason, which is included in the email to the vendor. 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.

The vendor screen

Click a store name to open it. You see the current balance, the amount available to withdraw, lifetime vendor earnings and your lifetime commission. From here you can:

  • Rename the store under Store details and click Save store details.
  • Read the answers to your application questions under Application details.
  • Review the identity document under Identity verification: View document, Approve, Reject (with an optional reason) or Delete.
  • Set a Commission for this vendor. It overrides the category and marketplace rules for every product of this vendor. A rule on a single product still wins.
  • Read the Ledger: every money movement, newest first. Entries are never edited or deleted.
  • Adjust balance: add or deduct an amount with a reason, for bonuses, fees or corrections made outside the store. The vendor sees the reason in their earnings history.
  • Assign a seller plan yourself, when you use seller plans. Plans assigned by you are free and never expire.

To list only one vendor's products, go to Products > All Products, pick the store in the All vendors dropdown and click Filter.

Vendors list with status links, a store search, bulk actions and a table of stores
Pending stores show an Approve button in the Actions column.
A single vendor screen with balance cards, Store details, Application details, Identity verification, Commission for this vendor, Ledger and Adjust balance
Set a per-vendor commission and record balance adjustments on the vendor screen.

#Orders, vendor orders and refunds

When a cart contains items from several vendors, the customer pays once and sees one order. Storefold creates a vendor order for each seller with only their items (after coupon discounts), their share of shipping and their tax. An order with a single vendor is simply assigned to that vendor. Your own products and fees stay on the main order.

On the customer's order in WooCommerce > Orders, the line under the customer shows the Vendor orders that belong to it.

  • Stock is reduced once, on the main order.
  • WooCommerce's own emails go out for the main order only. Each vendor gets one new vendor order email once the order is paid.
  • Vendor orders are kept out of WooCommerce Analytics, so each sale is counted once.
  • Changing the main order status (for example to Cancelled or Refunded) is copied to all vendor orders. When every vendor order is completed, the main order completes automatically.

Refunds

Refund the customer's order as usual, by item, shipping or amount. The refund is copied to the vendor orders it covers and the matching part of each vendor's earning (items, shipping and tax) is taken back. You can also click Refund on a vendor order: Storefold refunds those items on the customer's order. A refund made before the vendor earned the money is never paid out later. If the vendor was already paid, their balance can go below zero and is settled from future sales.

WooCommerce Edit order screen showing the Vendor orders line under the customer field
The customer's order lists its vendor orders and explains that refunds are copied to them.

#Commissions

Storefold > Commissions has one row per sold item: the order, vendor, product, Item total, what the Vendor keeps and what You keep, the status and the date.

  • Pending rows become Earned when the vendor order reaches the status you chose in Vendors earn their money when.
  • Reversed rows were taken back, for example by a refund or a cancelled order.

Filter by vendor, status and date range, then click Filter. Click Export CSV to download the list for your accountant.

The rule used is saved with each commission row, so later changes to your commission settings never rewrite history.

Commissions screen with vendor, status and date filters, an Export CSV button and a table of sold items
Vendor keeps and You keep show the split of every item.

#Withdrawals

Vendors request a payout from Payouts in their dashboard. Requests appear under Storefold > Withdrawals, grouped as Pending, Paid, Rejected and All.

To pay a request

  1. Send the money with the method the vendor chose (the Payout details column shows their PayPal email or bank details).
  2. Click Mark paid and enter the transaction reference.
  3. The amount leaves the vendor's balance and they get an email.

For vendors paid by Stripe (automatic transfer), marking the request paid transfers the money to their Stripe account and saves the Stripe transfer id as the reference.

To reject a request, give a short reason. Nothing leaves the vendor's balance and the vendor is emailed the reason.

To handle several requests at once, tick them, choose Mark as paid or Reject and click Apply to selected.

Vendors can only request what is available (their balance minus requests still waiting) and at least the Minimum withdrawal amount.

Withdrawals screen with Pending, Paid, Rejected and All links, a bulk action dropdown and the requests table
Record a reference with each payout so everyone has a receipt.

#Announcements

Use Storefold > Announcements to send a message to all your vendors. Enter a Title, write the message and click Publish announcement. Vendors see the latest announcements under From the marketplace team on their dashboard overview and in the Announcements section. Published announcements are listed below the form, where you can remove them again.

Announcements screen with a title field, a message box, a Publish announcement button and the list of published announcements
Published announcements show on every vendor's dashboard.

#Store reviews

Customers can rate a store from its store page. Storefold > Reviews lists every store review with the store, customer, rating, review text and status.

  • Waiting for approval holds new and edited reviews when Check new reviews before they appear is switched on in Settings.
  • Reported shows reviews that customers reported.
  • Hidden shows reviews you hid. Hidden reviews stay hidden even when the customer edits them.

You can approve, hide or delete any review. Reviews from buyers show a Verified buyer label, and sellers can reply from the Reviews section of their dashboard.

Store reviews screen with All, Waiting for approval, Reported and Hidden links and the reviews table
Approve, hide or delete what customers write about stores.

#Reports

Storefold > Reports shows the whole marketplace for a period: Marketplace sales, Vendor orders, You earned, Vendors earned and Refunds, each compared with the period before.

  • Pick Last 7 days, Last 30 days, This month, Last month or This year, or enter your own From and To dates and click Show these dates.
  • Sales per day shows a chart; click Show the numbers for the table.
  • Top vendors lists each vendor's sales, orders, what you earned, what they earned and their refunds.
  • Export vendors CSV and Export daily CSV download the data.

Unpaid and cancelled orders are never counted. Vendors see their own report under Reports in their dashboard (only the store owner, never staff).

Reports screen with period buttons, date fields, summary cards, a Sales per day chart and a Top vendors table
Each card compares the chosen period with the period before.

#Refund requests

When Let customers ask for a refund or a return from their order page is on, customers pick items and a reason on their order page within the number of days you set. They choose between a refund only and returning the item for a refund.

  1. The seller approves or declines the request (with a reason) under Refund requests in their dashboard.
  2. What happens next depends on Who sends the money back:
    • The seller approves, then you refund: the approved request waits for you under Storefold > Refund requests (filter Approved, refund on the way).
    • The seller's approval refunds the customer: the customer is refunded straight away through the payment method.
  3. To refund from this screen, add an optional note to the customer and choose Send the money back through the payment method, or Record the refund only, I pay the customer back myself when you pay back another way. Tick Put the items back in stock when the items come back.

Refunds always go through the customer's order and take the matching amount from the seller's earnings. When the payment method cannot refund automatically, approved requests wait for you. The customer, the seller and you are emailed at each step.

The status links are Waiting for the seller, Approved, refund on the way, Refunded, Declined and Cancelled.

Refund requests screen with status links for each stage of a request
Approved requests waiting for your refund also appear on the overview.

#Customer messages

Logged-in shoppers can ask a seller a question with Contact the seller on the store page or Ask the seller a question on a product page. Conversations appear for the customer under My Account > Seller messages and for the seller in the Messages section of their dashboard (staff with order access can answer too). Both sides get an email for each new message.

Under Storefold > Messages you can read every conversation, filter by store and status, post as the marketplace team (both the customer and the store see it, and the customer gets an email), close or reopen a conversation, or delete it when it breaks the rules.

Messages screen with store and status filters
Filter by store or by open and closed conversations.

#Disputes

Customers report a problem from their order page, one open report per seller and order. The customer, the seller and your team then talk in one conversation and can attach a photo or PDF. Everyone involved is emailed at each message, and the customer sees the conversation, status and decision on their order page.

Under Storefold > Disputes, open a dispute, read the conversation, ask questions if needed, then decide:

  • Refund the customer: send the money back through the payment method, or choose Record the refund only, I pay the customer back myself. Leave the amount empty to refund everything left on this seller's part. The vendor earning is reversed automatically.
  • Side with the vendor.
  • Close without action.

When the payment method cannot refund, the dispute stays open and you see why. The status links are Waiting for the seller, With the marketplace team, Resolved: refunded, Resolved in the seller's favour and Closed.

Disputes screen with status links for each dispute stage
Disputes waiting for a verdict are also listed on the overview.

#Activity log

Storefold > Activity is an audit trail of everything that happens on the marketplace, newest first: applications, approvals, products, offers, coupons, orders (split, assigned, paid, tracking, notes), money (earnings, refunds, adjustments, payouts, Stripe transfers), disputes, refund requests, plans, staff and settings changes, with who did it and when.

Filter by event type or vendor and click Filter. Click Download CSV to export. Older entries are deleted once a day after the number of days set in Keep the activity log for (Settings, Verification and vendor app).

Activity screen with event and vendor filters, a Download CSV button and the log table
Each row shows when, who, the event name and the details.

#Import vendors from CSV

Use Storefold > Import vendors when you move sellers from another marketplace plugin or a spreadsheet.

  1. Prepare a CSV with at least the columns email and store_name. Optional columns: phone, address, bio, website, paypal_email, status (approved or pending). Click Download the sample CSV for an example.
  2. Choose the file.
  3. Leave Email new accounts a password setup link ticked if new sellers should get a link to set their password.
  4. Click Preview only (no changes) to check the file. The preview shows the first 50 rows.
  5. Upload the same file again and click Import now.

Existing vendors are skipped, so importing the same file twice is safe. Only stores and their contact and payout details are imported, not products, orders or balances.

Import vendors from CSV screen with a file field, the password email checkbox and Preview and Import buttons
Always run a preview first.

#Settings: vendor rules and commission

All marketplace options live on one page, Storefold > Settings. Every option has a short explanation and a Learn more link to the built-in help. Click Save settings at the bottom when you are done.

Vendor rules decide who can sell and whether new products need your review:

  1. Choose how New vendor applications are handled. With manual approval new sellers wait until you approve them under Storefold > Vendors.
  2. Choose whether New vendor products go live at once or wait for your review. Products waiting for review appear under Products with the Pending status.
  3. To require seller terms, publish a page with your terms, tick Applicants must accept the seller terms and choose the page under Seller terms.

Commission is your cut of every vendor sale:

  1. Choose How do you take your cut?: a percentage, a fixed amount per item, or both.
  2. Enter Your percentage and Your fixed amount per item. The live example shows what you and the vendor get on a sale.
  3. Decide where Shipping charges go to and where Taxes go to. Commission is never taken from shipping or tax.
  4. Choose when Vendors earn their money.

Commission rules can also be set per product (the Marketplace commission field on the product's General tab), per vendor (Commission for this vendor on the vendor screen) and per product category (Products > Categories). The most specific rule wins: product, then vendor, then the vendor's seller plan, then category, then the marketplace default.

The full Marketplace settings page with all sections from Vendor rules to Data
All marketplace settings are on one page; save once at the bottom.
Vendor rules section with application and product approval choices and the seller terms option
Manual approval of applications is the recommended choice.
Commission section with commission type, percentage, fixed amount, shipping, tax and earning trigger settings
The live example updates as you type.

#Settings: payouts, earning hold and Stripe

Payouts decide how vendors withdraw what they earned.

Method What the vendor enters How the money moves
PayPal Their PayPal email You send the money, then mark the withdrawal as paid
Bank transfer Account holder, bank name, account number and routing or IBAN You send the money, then mark the withdrawal as paid
Stripe (automatic transfer) They click Connect with Stripe and finish Stripe's onboarding Paying a withdrawal transfers the money to their Stripe account

Set up Stripe payouts

  1. In your Stripe dashboard, enable Connect for a platform or marketplace.
  2. Copy the secret key from Developers, API keys.
  3. Paste it into Stripe secret key and tick Stripe (automatic transfer) under How vendors can get paid. Click Save settings.
  4. The setting then shows Connected with Test mode: no real money moves. or Live mode: payouts move real money., or Key rejected with Stripe's reason. For security the saved key is never shown again; only its last four characters are.
  5. Vendors click Connect with Stripe in their dashboard settings.

Use a sk_test_ key to try the flow without real money. The vendor's Stripe account is checked right before each transfer; when Stripe has paused payouts the vendor is asked to reconnect and the payout waits. A refund after a payout is taken from the vendor's next earnings, not pulled back from Stripe.

Earning hold: Hold new earnings for keeps new earnings from being withdrawn for a number of days, to cover your refund window. Earnings still appear on the balance at once.

Automatic payouts: choose Every Monday or On the 1st of every month and a threshold. On that day a payout request is created for every vendor whose available balance reaches the threshold and the minimum withdrawal. Stripe vendors are paid straight away; PayPal and bank requests wait under Storefold > Withdrawals for you to send the money. Vendors can switch automatic payouts off in their own settings.

Payouts section with the payout method checkboxes and the minimum withdrawal amount
Vendors pick one of the ticked methods in their dashboard settings.
Earning hold and Stripe payouts section with the hold days, automatic payout schedule, threshold and Stripe secret key
Paste your Stripe secret key here and tick Stripe under How vendors can get paid.

#Settings: refund and return requests

  1. Tick Let customers ask for a refund or a return from their order page.
  2. Set how many days after paying customers can ask (Customers can ask for).
  3. Choose Who sends the money back: you after the seller approves (recommended), or the seller's approval refunds the customer straight away through the payment method.

The customer picks the items and a reason. The seller and you are emailed, and the request appears in the vendor dashboard and under Storefold > Refund requests.

Refund and return requests section with the on and off switch, the number of days and the two refund approval choices
With the recommended choice you send every refund yourself.

#Settings: what vendors can sell and the application form

Selling existing products: tick Let vendors sell products that already exist in the catalog, with their own price and stock. Vendors then open Sell existing in their dashboard, search the catalog and add their own price and stock. The product page shows a More sellers box with every seller, cheapest first. Each sale goes to the seller the customer picked, and stock is tracked on their offer, so an offer can be bought while your own copy is sold out. Offers work on simple products.

Categories open to vendors: tick the categories vendors may use for new products and offers. Tick nothing to allow every category. Seller plans can limit this further.

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. For each question enter the wording, choose Short answer, Long answer or Dropdown, enter the choices for a dropdown (comma separated) and tick Required if it must be answered. Answers appear under Application details on the vendor screen, even after you rename a question.

What vendors can sell section with the existing products option and the category checkboxes
Leave every category unticked to allow all categories.
Vendor application form section with the question table and the Add a question button
Add short answer, long answer or dropdown questions.

#Settings: seller plans and extra product slots

Seller plans are optional free or paid tiers, for example a starter plan with 10 products at a higher commission and a bigger plan with unlimited products at a lower one.

Important: as soon as one plan exists, every vendor needs an active plan to list and sell (free plans count). Delete all plans to switch memberships off.

Add a plan

  1. Click Add a plan.
  2. Enter the Plan name, Price and Billing (Monthly or Yearly).
  3. Set the Product limit (the vendor's own products) and Existing-product limit (their offers on catalog products). 0 means unlimited.
  4. Optionally set Your commission % and Plus per item. They replace the marketplace and category rule for plan members; product and vendor rules still win.
  5. Optionally pick Only these categories to restrict where plan members may list.
  6. Click Save settings.

Vendors pick a plan under Membership in their dashboard. Paid plans are bought through normal checkout, one billing period per purchase. A reminder with a one-click renewal link goes out 3 days before expiry. After expiry the vendor cannot add or edit products, and after a 7 day grace period their products stop selling until they renew. Switching from one paid plan to another credits the unused time automatically.

Extra product slots let vendors on a limited plan buy more product slots without upgrading. Set Slots per pack and Pack price. Slots are a one time purchase and stack on top of the plan limit. Set either field to 0 to turn this off.

Seller plans section with the plan table and the Add a plan button
Creating the first plan makes plans required for every vendor.
Extra product slots section with Slots per pack and Pack price
Set either field to 0 to turn slot packs off.

#Settings: vendor shipping

Vendors set up their own shipping zones in their dashboard: countries, states and postcodes, with flat rate, free shipping, local pickup and table rate options. Vendors without zones use a simple base cost, cost per item and free shipping threshold, or the fallback cost set on the shipping method.

Switch it on

  1. In the Vendor shipping section, check the Status. Not Active means vendor rates are not charged yet.
  2. Click Add vendor shipping to all zones. You see the notice "Vendor shipping is now active in your shipping zones. Vendor rates apply at checkout." and the status turns Active.
  3. Manage the zones under WooCommerce > Settings > Shipping.

Shipping per seller: tick Let customers choose shipping separately for each seller to make each seller's items their own shipment at checkout, named "Shipped by" and the store name, with a shipping choice for each one. When this is off, one combined shipping charge covers every seller.

Every vendor order receives exactly the shipping its vendor charged, and a seller with nothing to ship gets none.

Vendor shipping section with the Not Active status, the Add vendor shipping to all zones button and the Shipping per seller option
One click adds the Vendor shipping method to all your zones.

#Settings: verification, vendor app and webhooks

Identity verification: vendors upload an ID or business licence (JPG, PNG or PDF up to 5 MB) under Settings in their dashboard. Review it from the vendor screen or the Verification pending view: View document, Approve, Reject (with an optional reason) or Delete. The vendor is emailed the decision. Verified stores show a badge on their store page, in the store directory and next to Sold by. Tick Vendors must be verified before their products can be bought to stop unverified vendors from selling.

Documents are protected by .htaccess and web.config files. On nginx, add a rule that denies uploads/storefold-multivendor-for-woocommerce-pro/.

Vendor app: with Let vendors install the dashboard on their phone and get new order alerts ticked, vendors can add the dashboard to their home screen. After clicking Enable order alerts they hear a chime and see a notification when a new paid order arrives while the dashboard is open. It uses your site icon (Appearance, Customize, Site Identity).

Activity log: Keep the activity log for sets how many days entries are kept.

Webhooks send marketplace events to Zapier, Make, n8n or your own system as signed JSON.

  1. Paste the receiving address into Webhook URL and click Save settings. Addresses on your own network (localhost or private IPs) are refused.
  2. Copy the Signing secret shown below it into the receiving system.
  3. Each request carries X-Storefold-Event (the event name), X-Storefold-Signature (the HMAC SHA-256 of the raw body with your secret) and X-Storefold-Timestamp. Compare the signature to be sure the request came from your site, and refuse old deliveries.

Events: vendor.registered, vendor.approved, order.created, order.paid, order.refunded, withdrawal.requested, withdrawal.paid, dispute.opened, plan.assigned. Leave the URL empty to switch webhooks off.

Verification and vendor app section with the verification rule, the vendor app option and the activity log days
Verified stores always show a badge, even when verification is optional.
Integrations section with the Webhook URL field and the Generate a new secret option
Tick Generate a new secret only when you want to replace the current one.

#Settings: storefront, marketplace pages and data

Storefront controls what shoppers see:

  • Show the store name on product pages, shop listings, cart, checkout and orders adds "Sold by" labels that link to the store page.
  • Only customers who bought from a store can review it stops reviews from people who never bought anything.
  • Check new reviews before they appear holds new and edited reviews under Storefold > Reviews until you approve them.

Marketplace pages are created automatically on activation. If you build your own pages, choose them here. Each page must contain its shortcode: [storefold_vendor_dashboard], [storefold_vendor_registration] and [storefold_store_list]. Store pages live at yoursite.com/store/store-name/ and need pretty permalinks.

Data: Delete all marketplace data when the plugin is deleted is off by default, so deleting the plugin keeps every table and setting. When on, deleting the plugin removes the marketplace tables, settings, the vendor role and the three pages. Data is always kept while another Storefold edition is installed.

Storefront section with the Sold by option and the two store review options
Turn on the purchase requirement once you have real orders.
Marketplace pages section with dropdowns for the vendor dashboard, become a vendor and store directory pages
Each page needs its shortcode.
Data section with the option to delete all marketplace data when the plugin is deleted
Leave this off unless you are sure: commissions and payouts are financial records.

#Setup wizard

Storefold > Setup wizard asks four questions and saves sensible settings for you:

  1. What kind of marketplace are you building? Physical products, digital downloads, services and bookings, a local multi-store, or wholesale. Choosing Digital downloads makes vendors earn their money as soon as payment is received; every other type waits for the order to be completed.
  2. What is your cut of each sale? The commission type, percentage and fixed amount per item, with a live example.
  3. How do vendors get paid? The payout methods and the minimum payout amount.
  4. How much do you want to review? Strict (you approve every vendor and every product), Balanced (you approve vendors once, then their products go live instantly) or Open (anyone can sign up and sell right away).

Click Continue after each step and Finish and open my marketplace at the end. Everything can be changed later under Storefold > Settings.

Setup wizard, step 1, with five marketplace types to choose from
Four quick questions; you can change every answer later.

#Help and docs

Storefold > Help and docs explains every option and screen in plain language inside wp-admin, with a contents list to jump to a topic. The Learn more links on the settings page open the matching entry here. It covers getting started, every settings section, managing vendors, orders and refunds, withdrawals, the vendor dashboard, emails, shortcodes, security and privacy, all Pro features and troubleshooting.

Help and documentation screen with a contents list and explanations of each topic
The built-in help is always one click away from the settings.

#Marketplace emails

Every marketplace email is a regular WooCommerce email. Open WooCommerce > Settings > Emails to switch each one on or off, change the subject, heading and body text, and preview it. Storefold adds 22 emails:

  • To you: Marketplace: new vendor application, Marketplace: product waiting for review, Marketplace: withdrawal requested, Marketplace: refund request (team), Marketplace: dispute update (team).
  • To vendors: Marketplace: store approved, Marketplace: vendor application rejected, Marketplace: store suspended, Marketplace: new vendor order, Marketplace: product approved, Marketplace: payout sent, Marketplace: payout declined, Marketplace: refund request (seller), Marketplace: dispute update (seller), Marketplace: verification decision, Marketplace: plan activated, Marketplace: plan reminder, Marketplace: plan expired.
  • To customers: Marketplace: refund request update (customer), Marketplace: dispute update (customer).
  • Others: Marketplace: new message and Marketplace: staff invitation.

Each email lists its placeholders under the Body text field, for example {store_name} and {order_number}. Leave Body text empty to use the default text. Click Send a test email to check the result.

Settings of the Marketplace: new vendor application email with subject, heading, body text, email type, Cc, Bcc and recipients
Admin emails have a Recipient(s) field.
Settings of the Marketplace: store approved email
Sent to the vendor when you approve their store.
Settings of the Marketplace: new vendor order email
Sent to the vendor once the customer has paid.

#The vendor dashboard

Vendors work from the Vendor Dashboard page on the front of your site. It adapts to your theme and works on phones. Logged-out visitors see a login form, and customers without a store see an invitation to apply.

  • Overview: sales and earnings at a glance, a setup checklist (logo, description, first product, payout method), orders waiting on them and the latest announcements.
  • Products: simple and variable products with images, gallery, stock, SKU, sale price, categories and downloads. When offers are on, Sell existing lets them sell catalog products.
  • Orders: only their own orders. They can mark paid orders as processing or completed, add a carrier and tracking number, and send the customer a note.
  • Messages, Refund requests and Disputes: answer customers.
  • Coupons: percentage or fixed coupons that only apply to their own products.
  • Earnings and Payouts: a breakdown per sold item with a CSV download, the ledger, and the withdrawal request form.
  • Reports: their own sales report (store owner only).
  • Staff: invite helpers and tick what each may do (products, orders, coupons). Staff never see earnings, payouts, reports, settings or the staff screen.
  • Membership: pick a seller plan, when you use plans.
  • Reviews: reply to store reviews.
  • Settings: store name, description, logo, banner, contact details, policies, vacation mode, payout details, Stripe connection and identity documents.

The Enable order alerts button switches on new order alerts when the vendor app option is on.

Vendor dashboard overview with the setup checklist, balance cards, orders waiting and announcements
The checklist guides new vendors through their first steps.
Products section of the vendor dashboard with a product table
Vendors add and edit their own products here.
Orders section of the vendor dashboard listing the vendor's orders with status
Vendors see only their own orders.
Earnings section of the vendor dashboard
Earnings list every sold item and can be downloaded as CSV.

Settings reference

Storefold > Vendors

The Add a vendor form at the top of the vendor list creates an approved store in one step.

The Storefold > Vendors screen
Storefold > Vendors

#Store name

Text

Shown after you click **Add a vendor**.

The name of the new store, shown on the store page and on Sold by labels.

When to change it

Fill it in when you create a store for a seller yourself instead of waiting for an application.

#Owner email

Email

Shown after you click **Add a vendor**.

The email of the store owner. An existing account with that email becomes the owner; otherwise a new account is created and emailed a link to set a password.

When to change it

Use an email that does not belong to an administrator or shop manager, because they cannot be vendors.

Storefold > Vendors > (store name)

The screen of a single vendor, opened by clicking a store name in the vendor list.

The Storefold > Vendors > (store name) screen
Storefold > Vendors > (store name)

#Store name

Text

Renames the store. Click Save store details to apply.

#Type

Dropdown

The commission rule for every product of this vendor. It overrides the category and marketplace rules; a rule set on a single product still wins.

When to change it

Set it for vendors who negotiated a different deal. Click Save commission to apply.

4 options

Use the category or marketplace rule

No override: the vendor uses the category rule or the marketplace default. Choose it to remove an override.

Percentage of the sale

You take Your percentage of the item price after discounts.

Fixed amount per item

You take Your fixed amount per item on every unit sold.

Percentage plus a fixed amount

You take the percentage plus the fixed amount on each unit. Your cut is never more than the item price.

#Your percentage

Number

The percentage used by this vendor's rule, from 0 to 100.

When to change it

Fill it in when Type is a percentage rule.

#Your fixed amount per item

Number

The fixed amount per unit used by this vendor's rule.

When to change it

Fill it in when Type uses a fixed amount.

#Direction

Dropdown Default: Add to balance

Whether the balance adjustment adds money to or takes money from the vendor's balance.

2 options

Add to balanceDefault

Adds the amount, for example a bonus or a correction in the vendor's favour.

Deduct from balance

Takes the amount off, for example a fee charged outside the store.

#Amount

Number

The amount to add or deduct. It must be above zero.

#Reason

Text

A short reason, shown to the vendor in their earnings history. Click Record adjustment to save it in the ledger.

When to change it

Always fill it in; an adjustment without a reason is refused.

WooCommerce > Orders > Edit order

The standard WooCommerce order screen. Storefold adds the Vendor orders line under the customer field, listing the vendor orders of a split order.

The WooCommerce > Orders > Edit order screen
WooCommerce > Orders > Edit order

#wc_order_action

Dropdown

The WooCommerce Order actions box: runs an action on this order when you click the arrow button.

4 options

Choose an action...

No action.

Send order details to customer

Emails the order details to the customer.

Resend new order notification

Sends the new order email to the shop again.

Regenerate download permissions

Rebuilds the download access for downloadable products in the order.

#Add note

Text area

Text of a new order note.

#Visibility

Dropdown

Who can see the new order note.

2 options

Private note

Only shop staff see the note.

Public note to customer

The customer sees the note and is emailed.

#Date created

Text

The date the order was created.

#Status

Dropdown

The order status. Changing the status of the customer's order (for example to Cancelled or Refunded) is copied to all its vendor orders, and when every vendor order is completed the main order completes automatically.

When to change it

Complete vendor orders to make vendor earnings earned when Vendors earn their money when is set to completed.

11 options

Pending payment

The order is not paid yet. Vendors are not emailed for unpaid orders.

Processing

Payment received. Vendors get their new order email, and earnings become earned if you chose payment as the trigger.

On hold

Waiting, for example for a bank payment.

Completed

The order is done. Earnings become earned with the recommended trigger.

Cancelled

The order was cancelled. Earnings of cancelled orders are dropped from all totals.

Refunded

The order was fully refunded.

Failed

Payment failed. Earnings of failed orders are dropped from all totals.

Draft

A checkout that was started but not placed.

Any status
Open
Closed

#Customer View other orders → Profile →

Dropdown

The customer the order belongs to. Below it Storefold lists the Vendor orders of this order and notes that refunds made on this order are copied to the vendor orders they cover.

Option

Jane Cooper (#1108 &ndash; jane.cooper+5fbkamytrz@example.com)

The customer account attached to this order; the list shows the customer you search for.

#Name

Dropdown Default: Select:

WooCommerce custom fields: the name of a custom field to add to the order.

4 options

Select:Default

No custom field chosen.

attribute_pa_scent

An existing custom field name from your store.

attribute_pa_size

An existing custom field name from your store.

total_sales

An existing custom field name from your store.

#Value

Text area

WooCommerce custom fields: the value of the custom field.

Storefold > Commissions

Filters above the commissions list. Click Filter to apply them, or Export CSV to download the list.

The Storefold > Commissions screen
Storefold > Commissions

#From

Dropdown Default: All vendors

Shows the commissions of one store, or of all stores.

9 options

All vendorsDefault

Shows every vendor's commissions.

Your Demo Store

Shows only the commissions of this store. The list holds one entry per store on your marketplace.

Harbor Candle Co.

Shows only the commissions of this store.

Common Thread Apparel

Shows only the commissions of this store.

Kiln & Co. Ceramics

Shows only the commissions of this store.

Any status
Pending
Earned
Reversed

#To

Date

The last date of the period to show.

Storefold > Withdrawals

The bulk action above the withdrawal requests. Tick requests, choose an action and click Apply to selected.

The Storefold > Withdrawals screen
Storefold > Withdrawals

#bulk_decision

Dropdown Default: Mark as paid

The action applied to all ticked withdrawal requests.

2 options

Mark as paidDefault

Records the ticked requests as paid. Send the money first; Stripe vendors are paid by transfer.

Reject

Rejects the ticked requests. Nothing leaves the vendors' balances.

Storefold > Announcements

Write a message that every vendor sees on their dashboard.

The Storefold > Announcements screen
Storefold > Announcements

#Title

Text

The title of the announcement.

#Write your message to vendors

Text area

The text of the announcement. Click Publish announcement to send it to every vendor dashboard.

Storefold > Reports

Pick your own period for the marketplace report.

The Storefold > Reports screen
Storefold > Reports

#From

Date

The first day of the report period. Click Show these dates to apply.

When to change it

Use it when none of the period buttons fit.

9 options

All vendors
Your Demo Store
Harbor Candle Co.
Common Thread Apparel
Kiln & Co. Ceramics
Any status
Pending
Earned
Reversed

#To

Date

The last day of the report period.

Storefold > Messages

Filters for the list of customer conversations. Click Filter to apply.

The Storefold > Messages screen
Storefold > Messages

#Store

Dropdown Default: All stores

Shows the conversations of one store or of all stores.

Option

All storesDefault

Shows every conversation. Stores with conversations are added to this list.

#Status

Dropdown

Filters conversations by status.

11 options

Any status

Shows open and closed conversations.

Open

Conversations that still accept replies.

Closed

Conversations where new replies are paused.

Pending payment
Processing
On hold
Completed
Cancelled
Refunded
Failed
Draft

Storefold > Activity

Filters for the activity log. Click Filter to apply or Download CSV to export.

The Storefold > Activity screen
Storefold > Activity

#Vendor

Dropdown

Filters the log by event type.

22 options

All events

Shows every event.

Vendors

Applications, approvals and other store changes.

Products

Vendor product changes and deletions.

Offers

Offers on existing catalog products.

Orders

Split, assigned and paid orders, tracking and customer notes.

Coupons

Vendor coupon changes.

Refund requests

Customer refund and return requests.

Balance adjustments

Amounts you added to or deducted from vendor balances.

Withdrawals

Payout requests, payments and rejections.

Commissions

Earned and reversed commissions.

Disputes

Dispute messages and decisions.

Verification

Identity documents and decisions.

Plans

Seller plan changes.

Slot packs

Extra product slot purchases.

Staff

Staff invitations and permission changes.

Stripe

Stripe connections and transfers.

Settings

Changes to the marketplace settings.

All vendors
Common Thread Apparel
Harbor Candle Co.
Kiln & Co. Ceramics
Your Demo Store

Storefold > Import vendors

Options for the CSV vendor import.

The Storefold > Import vendors screen
Storefold > Import vendors

#Email new accounts a password setup link

Checkbox Default: On

When ticked, every account created by the import gets an email with a link to set a password.

When to change it

Untick it when you want to tell your sellers about the move yourself before they get any email.

Storefold > Settings

Every marketplace option on one page, from vendor rules to data. Click Save settings at the bottom to save all sections at once.

The Storefold > Settings screen
Storefold > Settings

#New vendor applications

Choice Default: I review and approve each application (recommended)

Decides whether new sellers need your approval before they can sell.

When to change it

Keep manual approval unless you trust your audience or review products instead.

2 options

I review and approve each application (recommended)Default

Applicants see a pending screen until you approve them under Storefold, Vendors. They are emailed when you do.

Anyone who signs up can start selling right away

Every applicant becomes an approved vendor instantly. Fastest, but you have no say over who sells.

#New vendor products

Choice Default: Go live immediately

Decides whether new vendor products are published at once or wait for your review.

When to change it

Choose review when product quality or legal checks matter for your marketplace.

2 options

Go live immediatelyDefault

Products are published as soon as the vendor saves them.

Wait for my review before going live

New products are saved as Pending; publish them from Products in wp-admin. Edits to already published products stay live.

#Applicants must accept the seller terms

Checkbox Default: Off

Adds a required checkbox with a link to your seller terms page to the vendor application form. Applicants cannot submit without ticking it.

When to change it

Turn it on once you have published a page with your seller terms.

#Seller terms

Dropdown Default: Choose the page with your seller terms

The page with your seller terms, linked from the application form checkbox.

When to change it

Choose your terms page when Applicants must accept the seller terms is ticked.

8 options

Choose the page with your seller termsDefault

No page chosen.

Become a Vendor

Links the terms checkbox to this page.

Cart

Links the terms checkbox to this page.

Checkout

Links the terms checkbox to this page.

My account

Links the terms checkbox to this page.

Shop

Links the terms checkbox to this page.

Stores

Links the terms checkbox to this page.

Vendor Dashboard

Links the terms checkbox to this page.

#How do you take your cut?

Dropdown Default: Percentage of the sale

The marketplace default commission rule, calculated per sold item on the item total after coupons. Your cut is never more than the item price.

3 options

Percentage of the saleDefault

A share of the item price after discounts, for example 10% of a 50.00 item is 5.00.

Fixed amount per item

The same amount for every unit sold, for example 2.00 per unit, so 3 units cost the vendor 6.00.

Percentage plus a fixed amount

The percentage plus the fixed amount per unit, for example 10% plus 1.00 per unit.

#Your percentage

Number Default: 10

The percentage used by the commission rule, from 0 to 100.

#Your fixed amount per item

Number Default: 0

The fixed amount per unit used by the commission rule, in your shop currency.

#Shipping charges go to

Dropdown Default: The vendor (they ship the products)

Who receives the shipping the customer paid. Commission is never taken from shipping.

2 options

The vendor (they ship the products)Default

Each vendor's share of the order shipping is added to their earnings, commission free. Choose it when vendors ship their own products.

Me, the marketplace owner

Shipping stays with the marketplace. Choose it when you handle shipping yourself.

#Taxes go to

Dropdown Default: Me, the marketplace owner

Who receives the sales tax. Commission is never taken from tax.

2 options

Me, the marketplace ownerDefault

The marketplace keeps the sales tax and files it.

The vendor

Each seller is responsible for their own tax; their share of the order tax is added to their earnings.

#Vendors earn their money when

Dropdown Default: The order is completed (recommended)

Commission rows start as Pending and cannot be withdrawn. When the vendor order reaches this status they become Earned and the vendor balance goes up. Refunds take the matching amount back.

2 options

The order is completed (recommended)Default

Safest for physical goods: vendors earn once the order is completed.

Payment is received (order is processing)

Suits digital products that are delivered on payment.

#How vendors can get paid

Checkboxes Default: PayPal, Bank transfer

The payout methods vendors can choose in their dashboard settings.

When to change it

Tick Stripe only after you have saved a Stripe secret key.

3 options

PayPal

The vendor enters their PayPal email. You send the money, then mark the withdrawal as paid.

Bank transfer

The vendor enters account holder, bank name, account number and routing or IBAN. You send the money, then mark the withdrawal as paid.

Stripe (automatic transfer)

Vendors connect their Stripe account; paying a withdrawal transfers the money to it. Needs the Stripe secret key below.

#Minimum withdrawal amount

Number Default: 50

Vendors can only request a payout once their available balance reaches this amount. Keeps transfer fees down.

#Hold new earnings for

Number Default: 0

Earnings appear on the vendor balance at once but can only be withdrawn after this many days (0 to 365). 0 releases them instantly. Refunds inside the window reduce the held amount.

When to change it

Match it to your refund policy, for example 14.

#Automatic payouts

Dropdown Default: Off: vendors ask for each payout

Creates payout requests on a schedule for every vendor whose available balance reaches the threshold and the minimum withdrawal. Vendors can switch automatic payouts off in their own settings.

3 options

Off: vendors ask for each payoutDefault

No automatic requests; vendors request payouts themselves.

Every Monday

Creates the payout requests every Monday. Stripe vendors are paid straight away; PayPal and bank requests wait in Withdrawals.

On the 1st of every month

Creates the payout requests on the first day of every month, handled the same way.

#when the balance is at least

Number Default: 0

The balance a vendor must reach for an automatic payout request.

When to change it

Set it together with Automatic payouts.

#Stripe secret key

Password

Your Stripe secret key for Stripe Connect payouts. Enable Connect for a platform or marketplace in your Stripe dashboard and copy the key from Developers, API keys. After saving, the setting shows Connected (test or live mode) or Key rejected. For security the saved key is never shown again.

When to change it

Use a key starting with sk_test_ to try the flow without real money, then replace it with your live key.

#Remove the saved key

Checkbox

Shown when a Stripe secret key is saved.

Deletes the saved Stripe key when you save the settings.

When to change it

Use it to switch Stripe payouts off.

#Let customers ask for a refund or a return from their order page

Checkbox Default: On

Customers pick the items and a reason. The seller and you are emailed and the request appears in the vendor dashboard and under Storefold, Refund requests.

#Customers can ask for

Number Default: 30

How many days after paying customers can ask for a refund or return (1 to 365).

#Who sends the money back

Choice Default: The seller approves, then you refund (recommended)

Decides what happens when the seller approves a refund request. Refunds always go back through the customer's order and the matching amount is taken from the seller's earnings.

2 options

The seller approves, then you refund (recommended)Default

Approved requests wait for you under Storefold, Refund requests. You keep control of every refund.

The seller's approval refunds the customer straight away through the payment met

The seller's approval refunds the customer straight away through the payment method. When the payment method cannot refund automatically, approved requests wait for you.

#Let vendors sell products that already exist in the catalog, with their own price and stock

Checkbox Default: Off

Product pages then show a More sellers box. Each sale goes to the seller the customer picked, and stock is tracked per seller. Offers work on simple products.

#Categories open to vendors

Checkboxes

Limits which categories vendors can choose for new products and which products they can offer. Tick nothing to allow every category.

5 options

Accessories

Vendors may list and sell in this category. The list holds every product category of your shop.

Apparel

Vendors may list and sell in this category.

Home & Kitchen

Vendors may list and sell in this category.

Stationery

Vendors may list and sell in this category.

Uncategorized

Vendors may list and sell in this category.

#Question

Text

Shown for each question after you click **Add a question** in the Vendor application form section.

The wording of a custom question on the vendor application form.

#Answer type

Dropdown Default: Short answer

Shown for each question after you click **Add a question**.

How applicants answer the question.

3 options

Short answerDefault

A one line text field.

Long answer

A larger text box.

Dropdown

A list of choices; enter them under Choices.

#Choices (dropdown, comma separated)

Text

Shown for each question after you click **Add a question**.

The choices of a dropdown question, separated by commas.

When to change it

Fill it in only for Dropdown questions.

#Required

Checkbox Default: Off

Shown for each question after you click **Add a question**.

Applicants must answer the question to apply.

#Plan name

Text

Shown for each plan after you click **Add a plan** in the Seller plans section.

The name of a seller plan.

#Price

Number Default: 0

Shown for each plan after you click **Add a plan**.

The price per billing period. 0 makes it a free plan.

#Billing

Dropdown Default: Monthly

Shown for each plan after you click **Add a plan**.

The length of one billing period.

2 options

MonthlyDefault

Each purchase adds one month.

Yearly

Each purchase adds one year.

#Product limit (0 = unlimited)

Number Default: 0

Shown for each plan after you click **Add a plan**.

How many of their own products plan members may list.

#Existing-product limit (0 = unlimited)

Number Default: 0

Shown for each plan after you click **Add a plan**.

How many offers on existing catalog products plan members may have.

#Your commission %

Number

Shown for each plan after you click **Add a plan**.

The plan's commission percentage. Leave it empty to use the default rule. It replaces the marketplace and category rule for plan members; product and vendor rules still win.

#Plus per item

Number Default: 0

Shown for each plan after you click **Add a plan**.

An optional fixed commission per item added to the plan commission.

#Only these categories

Multi-select

Shown for each plan after you click **Add a plan**.

Restricts plan members to the chosen product categories. The list holds every product category of your shop.

#Slots per pack

Number Default: 0

How many extra product slots one pack adds on top of the plan limit.

When to change it

Set it with Pack price to sell slot packs. 0 turns slot packs off.

#Pack price

Number Default: 0

The price of one slot pack, a one time purchase. Set either field to 0 to turn this off.

#Let customers choose shipping separately for each seller

Checkbox Default: Off

Each seller's items become their own shipment at checkout, named "Shipped by" and the store name, and the customer picks a shipping option for each one. When off, one combined shipping charge covers every seller.

When to change it

Turn it on when sellers ship from different places and set their own rates.

#Vendors must be verified before their products can be bought

Checkbox Default: Off

Unverified vendors cannot sell. Vendors upload an ID or business licence under Settings in their dashboard; documents are stored privately and only marketplace managers can open them.

#Let vendors install the dashboard on their phone and get new order alerts

Checkbox Default: On

Vendors can add the dashboard to their home screen and switch on alerts for new paid orders. Uses your site icon. Alerts work while the dashboard is open, including as an installed app.

#Keep the activity log for

Number Default: 365

How many days activity log entries are kept (0 to 3650). Older entries are deleted once a day. 0 keeps everything.

#Webhook URL

URL

The address that receives marketplace events as signed JSON. Leave empty to switch webhooks off. Addresses on your own network (localhost or private IPs) are refused.

When to change it

Paste the webhook address from Zapier, Make, n8n or your own system.

#Generate a new secret

Checkbox Default: Off

Replaces the signing secret when you save. Each request carries an X-Storefold-Signature header: the HMAC SHA-256 of the raw body with this secret.

When to change it

Use it when the secret may have leaked, then update it in the receiving system.

#Show the store name on product pages, shop listings, cart, checkout and orders

Checkbox Default: 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 Default: Off

Only customers with an order from that store can leave a review.

When to change it

Recommended once you have real orders, to stop fake reviews.

#Check new reviews before they appear

Checkbox Default: Off

New and edited reviews wait under Storefold, Reviews until you approve them.

#Vendor dashboard

Dropdown

The page that holds the vendor dashboard. The page must contain the [storefold_vendor_dashboard] shortcode. The list holds all your pages.

When to change it

Change it only if you built your own page.

7 options

Become a Vendor

Uses this page as the vendor dashboard.

Cart

Uses this page as the vendor dashboard.

Checkout

Uses this page as the vendor dashboard.

My account

Uses this page as the vendor dashboard.

Shop

Uses this page as the vendor dashboard.

Stores

Uses this page as the vendor dashboard.

Vendor Dashboard

The page created on activation for the vendor dashboard.

#Become a vendor

Dropdown

The page with the vendor application form. The page must contain the [storefold_vendor_registration] shortcode.

When to change it

Change it only if you built your own page.

7 options

Become a Vendor

The page created on activation for applications.

Cart

Uses this page for applications.

Checkout

Uses this page for applications.

My account

Uses this page for applications.

Shop

Uses this page for applications.

Stores

Uses this page for applications.

Vendor Dashboard

Uses this page for applications.

#Store directory

Dropdown

The page with the list of stores. The page must contain the [storefold_store_list] shortcode.

When to change it

Change it only if you built your own page.

7 options

Become a Vendor

Uses this page as the store directory.

Cart

Uses this page as the store directory.

Checkout

Uses this page as the store directory.

My account

Uses this page as the store directory.

Shop

Uses this page as the store directory.

Stores

The page created on activation for the store directory.

Vendor Dashboard

Uses this page as the store directory.

#Delete all marketplace data when the plugin is deleted

Checkbox Default: Off

When on, deleting the plugin removes the marketplace tables, settings, the vendor role and the three pages. Data is always kept while another Storefold edition is installed.

When to change it

Leave this off unless you are sure: commissions and payouts are financial records.

Storefold > Setup wizard

Four questions that save your first marketplace settings. Click Continue to move to the next step.

The Storefold > Setup wizard screen
Storefold > Setup wizard

#Physical products Makers and resellers shipping goods.

Choice Default: Physical products Makers and resellers shipping goods.

Step 1, What kind of marketplace are you building? The choice also sets when vendors earn their money.

5 options

Physical products Makers and resellers shipping goods.Default

For makers and resellers who ship goods. Vendors earn when the order is completed.

Digital downloads Files, templates, and software. Earnings release as soon as pa

For files, templates and software. Earnings release as soon as payment clears (the order is processing).

Services and bookings Local pros and freelancers selling their time.

For local pros and freelancers selling their time. Vendors earn when the order is completed.

Local multi-store A city marketplace with pickup and delivery.

For a city marketplace with pickup and delivery. Vendors earn when the order is completed.

Wholesale or B2B Businesses selling to businesses in bulk.

For businesses selling to businesses in bulk. Vendors earn when the order is completed.

#2. What is your cut of each sale?

Dropdown Default: Percentage of the sale

Shown in step 2, after you click **Continue**.

Step 2: the commission type, saved as How do you take your cut?

3 options

Percentage of the saleDefault

A share of the item price after discounts.

Fixed amount per item

The same amount for every unit sold.

Percentage plus a fixed amount

The percentage plus the fixed amount per unit.

#Percentage

Number Default: 10

Shown in step 2.

Your commission percentage, from 0 to 100.

#Fixed per item

Number Default: 0

Shown in step 2.

Your fixed commission per unit sold.

#3. How do vendors get paid?

Checkboxes Default: PayPal, Bank transfer

Shown in step 3.

Step 3: the payout methods vendors can choose.

3 options

PayPal

Vendors enter their PayPal email; you send the money.

Bank transfer

Vendors enter their bank details; you send the money.

Stripe (automatic transfer)

Vendors connect Stripe and are paid by transfer. You also need to save a Stripe secret key in Settings.

#Minimum payout amount

Number Default: 50

Shown in step 3.

The smallest payout a vendor can request, saved as Minimum withdrawal amount.

#4. How much do you want to review?

Choice Default: Balanced (recommended)

Shown in step 4.

Step 4: sets New vendor applications and New vendor products in one go.

3 options

Strict

You approve every vendor and every product before it goes live.

Balanced (recommended)Default

You approve vendors once, then their products go live instantly.

Open

Anyone can sign up and sell right away. Fastest growth, least control.

WooCommerce > Settings > Emails > Marketplace: new vendor application

Sent to you when someone applies to open a store.

The WooCommerce > Settings > Emails > Marketplace: new vendor application screen
WooCommerce > Settings > Emails > Marketplace: new vendor application

#Enable/Disable

Checkbox Default: On

Switches this email on or off.

#Subject

Text

The email subject. Leave empty to use the default, [{site_title}] New vendor application: {store_name}.

#Email heading

Text

The heading at the top of the email. Leave empty to use the default, "New vendor application".

#Body text

Text area

The main text of this email. Simple HTML is allowed. Leave it empty to use the default text. Placeholders: {site_title}, {site_address}, {site_url}, {store_email}, {store_name}, {vendor_email}, {vendor_phone}, {what_they_sell}, {review_url}.

#Additional content

Text area

Extra text shown below the main email content.

#Email type

Dropdown Default: HTML

The format of the email.

3 options

Plain text

Text only, no formatting.

HTMLDefault

Formatted email using the WooCommerce email design.

Multipart

Sends both versions; the mail program picks one.

#Cc(s)

Text

Extra addresses that get a copy, separated by commas.

#Bcc(s)

Text

Extra addresses that get a hidden copy, separated by commas.

#Recipient(s)

Text

Who receives the application email, separated by commas.

When to change it

Add the address of whoever reviews new sellers.

WooCommerce > Settings > Emails > Marketplace: store approved

Sent to the vendor when you approve their store.

The WooCommerce > Settings > Emails > Marketplace: store approved screen
WooCommerce > Settings > Emails > Marketplace: store approved

#Enable/Disable

Checkbox Default: On

Switches this email on or off.

#Subject

Text

The email subject. Leave empty to use the default, Your store {store_name} is approved.

#Email heading

Text

The heading at the top of the email. Leave empty to use the default, "Welcome aboard!".

#Body text

Text area

The main text of this email. Simple HTML is allowed. Leave it empty to use the default text. Placeholders: {site_title}, {site_address}, {site_url}, {store_email}, {store_name}, {store_url}, {dashboard_url}.

#Additional content

Text area

Extra text shown below the main email content.

#Email type

Dropdown Default: HTML

The format of the email.

3 options

Plain text

Text only, no formatting.

HTMLDefault

Formatted email using the WooCommerce email design.

Multipart

Sends both versions; the mail program picks one.

#Cc(s)

Text

Extra addresses that get a copy, separated by commas.

#Bcc(s)

Text

Extra addresses that get a hidden copy, separated by commas.

WooCommerce > Settings > Emails > Marketplace: new vendor order

Sent to the vendor with a full order table once the customer has paid for an order with their products.

The WooCommerce > Settings > Emails > Marketplace: new vendor order screen
WooCommerce > Settings > Emails > Marketplace: new vendor order

#Enable/Disable

Checkbox Default: On

Switches this email on or off.

#Subject

Text

The email subject. Leave empty to use the default, New order #{order_number} for {store_name}.

#Email heading

Text

The heading at the top of the email. Leave empty to use the default, "You have a new order!".

#Body text

Text area

The main text of this email. Simple HTML is allowed. Leave it empty to use the default text. Placeholders: {site_title}, {site_address}, {site_url}, {store_email}, {store_name}, {order_number}, {order_total}, {order_date}, {customer_name}, {order_details}, {orders_url}.

#Additional content

Text area

Extra text shown below the main email content.

#Email type

Dropdown Default: HTML

The format of the email.

3 options

Plain text

Text only, no formatting.

HTMLDefault

Formatted email using the WooCommerce email design.

Multipart

Sends both versions; the mail program picks one.

#Cc(s)

Text

Extra addresses that get a copy, separated by commas.

#Bcc(s)

Text

Extra addresses that get a hidden copy, separated by commas.

When to change it

Add your own address here to follow every vendor order.

Shortcodes

[storefold_vendor_dashboard]

The vendor dashboard. Logged-out visitors see a login form, and customers without a store see an invitation to apply. Set the page that holds it under **Storefold > Settings > Marketplace pages**.

[storefold_vendor_dashboard]

[storefold_vendor_registration]

The step-by-step vendor application form. Logged-out visitors create their account in the same form. Vendors who already have a store see a link to their dashboard.

[storefold_vendor_registration]

[storefold_store_list]

A searchable grid of approved stores with logo, rating and product count, sorted by store name and split into pages.

[storefold_store_list]

On your site

Shoppers see the marketplace on these pages:

  • Stores: the store directory ([storefold_store_list]), a searchable grid of approved stores. Verified stores show a badge.
  • Store pages: every approved store gets its own page at yoursite.com/store/store-name/ with banner, logo, description, policies, products and reviews. Logged-in shoppers can use Contact the seller and rate the store under Review this store. When a store is on vacation, its products cannot be bought and the vacation message is shown.
  • Sold by labels: "Sold by" and the store name under the product title, "by" and the store name in shop listings, and a Sold by line in the cart, checkout (classic and block), account orders and emails.
  • Product pages: Ask the seller a question, and a More sellers box when vendors may sell existing products.
  • Checkout: with Shipping per seller on, each seller's items appear as their own shipment, named "Shipped by" and the store name, with a shipping choice for each.
  • My Account: customers find their conversations under Seller messages. On their order page they can ask for a refund or a return and report a problem (dispute), and see the status and decision.
  • Become a Vendor: the application form ([storefold_vendor_registration]). Visitors who already have a store see a link to their dashboard.
Stores page with a store search box and a grid of store cards
The store directory lists approved stores only.
A store page with banner, Contact the seller, the store's products, reviews and a Review this store form
Each product card shows which store sells it.
Become a Vendor page showing the message You are already a vendor with a Go to my dashboard button
Existing vendors are sent to their dashboard instead of the form.

Frequently asked questions

Do I need the free edition as well?

No. Pro contains everything. When Pro is active the free edition stays idle and shows a notice on the Plugins screen, so you can deactivate and delete it.

Will I lose data when switching from free to Pro?

No. Both editions share the same tables and settings, so every vendor, order, commission and setting carries over.

Which payout methods can vendors use?

PayPal, Bank transfer and Stripe (automatic transfer). With PayPal and bank transfer you send the money yourself and mark the withdrawal as paid. With Stripe, vendors connect their own Stripe account and paying a withdrawal transfers the money to it. Stripe needs Connect enabled in your Stripe dashboard and your secret key in Storefold > Settings. Splitting the card payment between sellers at checkout is not part of Storefold.

How do refunds work on an order with several sellers?

The customer paid once, so money always goes back through the customer's order and its payment method. Refund the customer's order as usual and Storefold copies the refund to the vendor orders it covers, taking the matching amount from each vendor's earnings. You can also click Refund on a vendor order. Refund requests and dispute refunds work the same way.

Do customers get several emails for one order?

No. WooCommerce's own order emails are sent for the customer's order only. Each vendor gets one new vendor order email once the order is paid.

Do vendor orders show up twice in WooCommerce Analytics?

No. Vendor orders are kept out of Analytics, so a split order is counted once. For orders placed before version 1.4.0, go to Analytics > Settings, delete the previously imported data and import the historical data again.

Can I charge different commissions for different vendors or products?

Yes. Set a rule per product (the Marketplace commission field on the product's General tab), per vendor (Commission for this vendor on the vendor screen), per seller plan, or per product category. The most specific rule wins: product, then vendor, then seller plan, then category, then the marketplace default.

Can several vendors sell the same product?

Yes, when you tick Let vendors sell products that already exist in the catalog, with their own price and stock. The product page then shows a More sellers box. Offers use their own stock, so they can still be bought when your own copy is sold out. Offers work on simple products.

Can vendors give their staff access?

Yes. Store owners invite helpers under Staff in their dashboard and tick what each may do: products, orders and coupons. New staff get an invitation email. Staff never see earnings, payouts, reports, settings or the staff screen.

Can I move my sellers from another marketplace plugin?

Yes, with Storefold > Import vendors. Export your sellers to a CSV with at least email and store_name, preview it, then import. Only stores and their contact and payout details are imported, not products, orders or balances.

Which external services does Storefold Pro connect to?

Only the ones you use: the Stripe API when Stripe payouts are enabled, and the webhook address you enter. No other data leaves your site.

What happens to my data when I delete the plugin?

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

Troubleshooting

"Stripe is enabled but the key is missing or rejected. Fix it in Settings."

Stripe (automatic transfer) is ticked but no valid key is saved. In your Stripe dashboard enable Connect for a platform or marketplace, copy the secret key from Developers, API keys, paste it into Stripe secret key under Storefold > Settings and click Save settings. The setting should show Connected. If it shows Key rejected, read Stripe's reason next to it and paste a new key.

"Stripe has paused payouts on this vendor account. The vendor needs to open Settings and click Connect with Stripe to finish what Stripe asks for."

Stripe needs more information from the vendor. Ask the vendor to open Settings in their dashboard and click Connect with Stripe. The payout waits until the account is ready.

"Vendor shipping is not in any shipping zone, so vendor rates are not charged. One click in Settings, Vendor shipping fixes it."

Go to Storefold > Settings, section Vendor shipping, and click Add vendor shipping to all zones. The status changes to Active and vendor rates are charged at checkout.

"That email belongs to a site administrator. Administrators cannot become vendors."

A store always belongs to its own account, and administrators and shop managers cannot open one. Use a different email address for the store owner. To test the vendor side, apply with a separate account.

Store pages show "Page not found"

Store pages need pretty permalinks. Open Settings > Permalinks and click Save Changes without changing anything. Plain permalinks are not supported for store pages.

A vendor does not receive order emails

The email goes out once the order is paid (Processing or Completed), not for unpaid orders. Check that Marketplace: new vendor order is enabled under WooCommerce > Settings > Emails, and that your site can send email at all (an SMTP plugin helps).

Earnings stay pending

Earnings become earned when the vendor order reaches the status set in Vendors earn their money when. Complete the order, or switch the setting to Payment is received (order is processing). Also check Hold new earnings for: held earnings show on the balance but cannot be withdrawn until the hold ends.

"Enter an amount above zero and a short reason for the adjustment."

On the vendor screen, Adjust balance needs both an Amount above zero and a Reason. Fill in both and click Record adjustment again.

"Please choose a CSV file to upload." or "No usable rows were found in the file."

Choose the file before clicking Preview only (no changes) or Import now. Make sure it is a CSV with the columns email and store_name. Click Download the sample CSV for an example of the format.

A refund shows "(this payment method cannot refund automatically)"

The customer's payment method cannot send money back on its own. Pay the customer back another way, then choose Record the refund only, I pay the customer back myself. The refund is recorded and the matching amount is taken from the seller's earnings.