Skip to content

Also called: set up marketplace, Dokan setup wizard, store list page, vendor registration, first vendor, first product, nothing shows, test vendor

The add-on only styles what Dokan already shows. If Dokan has no store list page, no vendor and no published product, there is nothing to style. This guide gets Dokan to the point where the add-on has something to show. Read it first if your stores, hearts or profile tabs do not appear.

Item What the add-on checks
Reign theme Version 8.1.0 or newer. A Reign child theme counts. A beta such as 8.1.0-beta.1 counts as 8.1.0.
WooCommerce Active. The add-on does not check its version.
Dokan Lite Active. The add-on does not check its version. This guide was checked against Dokan Lite 5.3.4 and WooCommerce 11.2.2.
Dokan Pro Optional. Checked against Dokan Pro 5.3.5. Pro’s own features are left alone.
Other marketplace plugins WC Vendors and WCFM Marketplace must be deactivated.

Dokan Lite 5.3.4 itself asks for WordPress 7.0 or newer. The add-on asks for PHP 8.1 or newer.

If something is missing, the add-on stays paused. It shows one notice: “Reign Dokan Addon is paused. Your settings are kept.” The notice names what to install, update or deactivate. Fix those items and the add-on starts on the next page load.

BuddyPress or BuddyBoss Platform is optional. It adds two things:

  • Members: the Store tab on vendor profiles and the Favourite products tab on your own profile.
  • Activity: the activity cards for new products, reviews and purchases. Turn the Activity component on in BuddyPress or BuddyBoss settings.

The heart and the Favourite products page in My Account work without any community plugin. PeepSo is not used.

  1. Install and activate the Reign theme, version 8.1.0 or newer.
  2. Install and activate WooCommerce.
  3. Install and activate Dokan Lite.
  4. Install and activate Dokan Pro, if you have it.
  5. Install and activate BuddyPress or BuddyBoss Platform, if you want profile tabs and activity cards.
  6. Install and activate Reign Dokan Addon.
  7. Go to Reign Settings > License and enter your key in the Reign Dokan Addon row.

After you activate Dokan Lite, it opens a setup wizard. If you skipped it, open wp-admin/admin.php?page=dokan-setup. The wizard is optional and you can change every choice later. Click Skip this step on any step you do not need.

Only these choices matter for the add-on:

Wizard step Field Recommended Why
Store Vendor Store URL Leave it as store Store pages become yourdomain.com/store/vendor-name. Changing it later breaks old store links.
Store Map API Source and API key Add a Google Maps API key or a Mapbox access token if you want a map on store pages Without a key, store pages show no map. This is Dokan’s map, not the add-on’s.
Selling New Vendor Enable Selling Automatically for an open marketplace, Manually if you approve every vendor A vendor whose selling is not enabled has no store page, so the add-on shows no link to it.
Commission Commission type and amount Keep Fixed and set the percentage the marketplace keeps The add-on does not use commission. Set it now so your first test order has the right split.
Withdraw Any Skip Payouts have no effect on the add-on.

Dokan creates its pages when you first activate it: Dashboard, Store List, My Orders and Vendor Onboarding. WooCommerce creates My Account.

  1. Go to Dokan > Settings > General > Page Setup.
  2. Set Dashboard to the page that holds [dokan-dashboard].
  3. Set Store Listing to the page that holds [dokan-stores].
  4. Set My Orders to the page that holds [dokan-my-orders].
  5. Click Save Changes.

If a page was deleted, create a new page and paste the shortcode into it. Then select it in Page Setup. The store card style applies to the Store Listing page, so that page must hold [dokan-stores].

Now check My Account:

  1. Go to WooCommerce > Settings > Advanced.
  2. Under Page setup, set My account page to a page that holds the [woocommerce_my_account] shortcode.
  3. Click Save changes.
  4. Go to Settings > Permalinks and click Save Changes once, so the store and favourites addresses work.

Dokan adds an “I am a customer / I am a vendor” choice to the WooCommerce sign-up form.

  1. Go to WooCommerce > Settings > Accounts & Privacy.
  2. Tick Allow customers to create an account on the “My account” page.
  3. Go to Dokan > Settings > Vendors > Vendor Onboarding.
  4. Turn on Show “Register as a Vendor” in Sign Up Page.
  5. Click Save Changes.

Dokan usually switches the My Account sign-up on during its own setup. If you set Enable Selling to Manually, approve each new vendor from Dokan > Vendors.

  1. Register a test vendor on the My Account sign-up form. Choose “I am a vendor”.
  2. Log in as that vendor and open the vendor dashboard. Fill in the store name and details under Settings > Store.
  3. Add one product with a title, a price and an image.
  4. Check the product status. With Dokan Lite, a new vendor’s products wait as Pending unless the vendor is trusted. Open Products in the admin and publish the product.
  5. Register a second user as a customer, so you can test the heart and a purchase.
  6. For the community features, use a vendor with a BuddyPress or BuddyBoss profile. Every member has one.
  1. Your Store Listing page shows a card for the vendor in the style you chose under Reign Settings > Integrations, then Configure on the Dokan tile, then the Store card.
  2. A published product shows a “Sold by” line with the store name. When you are logged in, it also shows a heart beside Add to cart.
  3. After you click the heart as the customer, My Account has a Favourite products page that lists the product.
  4. With BuddyPress or BuddyBoss, the vendor’s profile has a Store tab with the product. The customer’s own profile has a Favourite products tab.
  5. With the Activity component on, publishing a product or posting a review adds an activity card.

Use this table to find the cause.

Symptom Fix
The admin shows “Reign Dokan Addon is paused” Follow each line of the notice. See Messages and what they mean.
The store list is empty or the card style does not change Select the Store Listing page in Dokan > Settings > General > Page Setup, and make sure it holds [dokan-stores]. Check that at least one vendor has selling enabled.
No “Sold by” line The product must belong to a vendor with selling enabled, and Vendor block must be set to Sold by line.
The vendor’s Store tab shows no products The products are still Pending. Publish them.
The Favourite products page in My Account gives a 404 Save Settings > Permalinks once.
No profile tabs or activity cards BuddyPress or BuddyBoss must be active. The Activity component must be on for activity cards.
Hearts or tabs appear twice, or the add-on is paused WC Vendors or WCFM Marketplace is also active. Deactivate it.

More fixes are in Troubleshooting.