Skip to content

Also called: set up marketplace, vendor shop setup, seller dashboard setup, vendor list page, store page, WC Vendors wizard, first vendor.

WC Vendors Pro is optional.

Reign WC Vendor Addon adds a layer on top of WC Vendors. If WC Vendors has no vendors, no store and no products yet, the add-on has nothing to show, and it can look broken. This guide takes a new site from a bare install to a working marketplace.

Needs Version the add-on checks
Reign theme 8.1.0 or newer. A child theme of Reign counts.
WooCommerce Active. Verified with 11.2.2.
WC Vendors 2.7.0 or newer. Verified with 2.7.3.
WC Vendors Pro Optional. Verified with 2.1.0.
BuddyPress or BuddyBoss Optional. Needed only for the profile tabs and activity posts.
  • One marketplace at a time. If Dokan Lite or WCFM Marketplace is active too, the add-on pauses. Its admin notice asks you to deactivate the other one. Your settings are kept. Deactivate the other marketplace, and the add-on starts again.
  • Community features. The Store tab and the Favourites tab on profiles need the Members component of BuddyPress or BuddyBoss. The activity posts (new product, new review, purchase) need the Activity component. The add-on does not use PeepSo. The heart and the My Account Favourites page work without any community plugin.
  1. Install and activate the Reign theme, version 8.1.0 or newer.
  2. Install and activate WooCommerce.
  3. Install and activate WC Vendors.
  4. Optional: install and activate WC Vendors Pro.
  5. Optional: install and activate BuddyPress or BuddyBoss.
  6. Install and activate Reign WC Vendor Addon.
  7. Go to Reign Settings > License, find the Reign WC Vendors Addon row and enter your licence key.

WC Vendors opens a wizard after activation. To open it again, go to WC Vendors > Setup Wizard. The wizard creates the Vendor Dashboard page and the Vendors page for you.

The first screen offers Get Started or One Click Setup. One Click Setup applies the plugin’s recommended settings and finishes the wizard. If you use it, you can skip to Pages and permalinks and change anything later under WC Vendors > Settings.

If you click Get Started, these are the choices that matter.

  1. Set Global Commission Rate % to the share of each sale that goes to the vendor. The default is 50. This is the default for every product, and you can override it per vendor or per product later.
  2. Set Payout Currency to your store currency, so payouts and reports use the same one.
  1. Set Store Base URL to vendors, or to a word your customers will understand. A store then lives at yoursite.com/vendors/store-name/.
  2. Set Vendor Terms Page if you have a terms page for vendors. Leave it empty if you do not.
  3. Turn on Manually approve Vendor applications if you want to review each applicant. Leave it off to approve everyone automatically, which suits a test site.
  4. Leave Give any taxes to Vendor and Give any shipping to Vendor off unless you pay vendors those amounts. Both default to off.
  5. Choose whether vendors can export their orders to a CSV file.

The wizard’s later steps are Recommended Plugins and Finish. On the last screen, Add Products and View Settings take you straight to the next tasks.

The labels use your own word for vendors. If you renamed vendors under WC Vendors > Settings > Display > Labels, you will see that word instead.

Open WC Vendors > Settings > General and check that Vendor Registration is on. When it is on, customers can apply to become a vendor from the registration form. The add-on does not change this.

WC Vendors needs two pages. The setup wizard creates both.

Page What it holds Where you choose it
Vendor Dashboard The shortcode [wcv_vendor_dashboard] WC Vendors > Settings > Display, Pages, Dashboard
Vendors (the store list) The shortcode [wcv_vendorslist] WC Vendors > Settings > Display, Pages, Vendors

If you skipped the wizard, or deleted a page:

  1. Go to Pages > Add New.
  2. Give the page a title, such as Vendor Dashboard.
  3. Add a Shortcode block with [wcv_vendor_dashboard], or [wcv_vendorslist] for the store list.
  4. Publish the page.
  5. Go to WC Vendors > Settings > Display and pick the page in the matching field under Pages.
  6. Click Save changes.

The My Account page comes from WooCommerce. The add-on adds a Favourites page to it. See Troubleshooting if it shows “page not found”.

After you change Store Base URL (on the same Display screen, under Store Settings), go to Settings > Permalinks and click Save Changes once. Without this, store pages can return “page not found”.

The add-on shows nothing useful until a vendor has a store and a product. Do this on a test site first.

  1. Go to Users > Add New User, create a user and give them the Vendor role. Or sign in as a customer and apply through the registration form, then approve the application from Users, where pending applicants are listed.
  2. Open that user’s profile and check that Shop Name is filled in. A vendor with an empty shop name has no working store URL.
  3. Sign in as the vendor and open the vendor dashboard page.
  4. Add a product with a title, a price and an image, and publish it. A product the vendor has saved as a draft does not show in the store.
  5. As a customer, open the product, then post a review on it. Reviews are what make the review activity card.
  1. Open the Vendors page. You see the vendor’s store, from WC Vendors.
  2. Open the store. The store header and the product list come from WC Vendors.
  3. Open a product as a signed-in customer. You see the Reign heart on the product, and the “Sold by” line from WC Vendors on the product page.
  4. Click the heart, then open My Account > Favourites. The product is listed.
  5. With BuddyPress or BuddyBoss active, open the vendor’s member profile. You see a Store tab with their published products.
  6. Open your own profile as the customer. You see a Favourites tab.
  7. Open the activity feed. You see a card for the new product and for the review. The purchase card is off by default; turn it on under Reign Settings > Integrations, then Configure on the WC Vendors tile.

If the Store tab or the activity cards are missing on BuddyBoss with WC Vendors Pro, that is expected: Pro provides them. See Install and requirements.

What you see Why Fix
The admin notice says the add-on is paused Another marketplace is active, WC Vendors is older than 2.7.0, or Reign is older than 8.1.0 Do what the notice says. See Troubleshooting.
Store pages show “page not found” Permalinks were not refreshed after setting the Store Base URL Save Settings > Permalinks once.
The Vendors page is empty No vendor has a shop name or a published product, or the page is missing the shortcode Complete the minimum content steps and check the page holds [wcv_vendorslist].
The vendor dashboard is blank or missing The Dashboard page is not chosen Pick it under WC Vendors > Settings > Display, Pages.
No Store tab on profiles BuddyPress or BuddyBoss is off, the user is not a vendor, or the Store tab switch is off Check the plugin, the user’s role and Reign Settings > Integrations, then Configure on the WC Vendors tile.
No heart for visitors Favourites belong to a signed-in member Sign in to test.
No activity cards The Activity component is off, or the card’s switch is off Turn on Activity in your community plugin and check the switches.