Set up Dokan for Reign
Also called: set up marketplace, Dokan setup wizard, store list page, vendor registration, first vendor, first product, nothing shows, test vendor
What this does
Section titled “What this does”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.
Before you start
Section titled “Before you start”| 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.
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 Dokan Lite.
- Install and activate Dokan Pro, if you have it.
- Install and activate BuddyPress or BuddyBoss Platform, if you want profile tabs and activity cards.
- Install and activate Reign Dokan Addon.
- Go to Reign Settings > License and enter your key in the Reign Dokan Addon row.
Run the Dokan setup wizard
Section titled “Run the Dokan setup wizard”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. |
Check your pages
Section titled “Check your pages”Dokan creates its pages when you first activate it: Dashboard, Store List, My Orders and Vendor Onboarding. WooCommerce creates My Account.
- Go to Dokan > Settings > General > Page Setup.
- Set Dashboard to the page that holds
[dokan-dashboard]. - Set Store Listing to the page that holds
[dokan-stores]. - Set My Orders to the page that holds
[dokan-my-orders]. - 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:
- Go to WooCommerce > Settings > Advanced.
- Under Page setup, set My account page to a page that holds the
[woocommerce_my_account]shortcode. - Click Save changes.
- Go to Settings > Permalinks and click Save Changes once, so the store and favourites addresses work.
Let people register as vendors
Section titled “Let people register as vendors”Dokan adds an “I am a customer / I am a vendor” choice to the WooCommerce sign-up form.
- Go to WooCommerce > Settings > Accounts & Privacy.
- Tick Allow customers to create an account on the “My account” page.
- Go to Dokan > Settings > Vendors > Vendor Onboarding.
- Turn on Show “Register as a Vendor” in Sign Up Page.
- 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.
Add the minimum content
Section titled “Add the minimum content”- Register a test vendor on the My Account sign-up form. Choose “I am a vendor”.
- Log in as that vendor and open the vendor dashboard. Fill in the store name and details under Settings > Store.
- Add one product with a title, a price and an image.
- 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.
- Register a second user as a customer, so you can test the heart and a purchase.
- For the community features, use a vendor with a BuddyPress or BuddyBoss profile. Every member has one.
You’ll know it worked when
Section titled “You’ll know it worked when”- 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.
- 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.
- After you click the heart as the customer, My Account has a Favourite products page that lists the product.
- 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.
- With the Activity component on, publishing a product or posting a review adds an activity card.
Good to know
Section titled “Good to know”Why does nothing show?
Section titled “Why does nothing show?”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.

