Set up WC Vendors for Reign
Reign WC Vendors Addon overviewPremiumGet Reign WC Vendors Addon →
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.
What you need
Section titled “What you need”| 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.
Install in this order
Section titled “Install in this order”- Install and activate the Reign theme, version 8.1.0 or newer.
- Install and activate WooCommerce.
- Install and activate WC Vendors.
- Optional: install and activate WC Vendors Pro.
- Optional: install and activate BuddyPress or BuddyBoss.
- Install and activate Reign WC Vendor Addon.
- Go to Reign Settings > License, find the Reign WC Vendors Addon row and enter your licence key.
Run the WC Vendors setup wizard
Section titled “Run the WC Vendors setup wizard”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.
Marketplace step
Section titled “Marketplace step”- 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.
- Set Payout Currency to your store currency, so payouts and reports use the same one.
Vendor step
Section titled “Vendor step”- Set Store Base URL to
vendors, or to a word your customers will understand. A store then lives atyoursite.com/vendors/store-name/. - Set Vendor Terms Page if you have a terms page for vendors. Leave it empty if you do not.
- 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.
- Leave Give any taxes to Vendor and Give any shipping to Vendor off unless you pay vendors those amounts. Both default to off.
- 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.
Allow vendor registration
Section titled “Allow vendor registration”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.
Pages and permalinks
Section titled “Pages and permalinks”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:
- Go to Pages > Add New.
- Give the page a title, such as Vendor Dashboard.
- Add a Shortcode block with
[wcv_vendor_dashboard], or[wcv_vendorslist]for the store list. - Publish the page.
- Go to WC Vendors > Settings > Display and pick the page in the matching field under Pages.
- 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”.
Add the minimum content
Section titled “Add the minimum content”The add-on shows nothing useful until a vendor has a store and a product. Do this on a test site first.
- 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.
- 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.
- Sign in as the vendor and open the vendor dashboard page.
- 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.
- As a customer, open the product, then post a review on it. Reviews are what make the review activity card.
Check it works
Section titled “Check it works”- Open the Vendors page. You see the vendor’s store, from WC Vendors.
- Open the store. The store header and the product list come from WC Vendors.
- 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.
- Click the heart, then open My Account > Favourites. The product is listed.
- With BuddyPress or BuddyBoss active, open the vendor’s member profile. You see a Store tab with their published products.
- Open your own profile as the customer. You see a Favourites tab.
- 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.
Common setup mistakes
Section titled “Common setup mistakes”| 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. |

