Premium version settings - Doc of YITH WooCommerce Multi Vendor / Marketplace

Product management

Home > Premium version settings

All vendors in the shop can create and manage their own products right from their dashboard.

Vendors will be able to see the Products menu in their dashboard. It is very similar to the one of the admin, but they will only see their own products.

When a vendor creates a product from this page, it will be automatically associated to his/her store and this will be visible to the admin in a dedicated column on the Products page…

… and in the product details where it is also possible for the admin to change the vendor.

Vendor in product — See and select vendor from product detail page

You can also assign products in bulk from the Bulk actions dropdown and select the vendor:

Please, note: one product can only be assigned to one vendor. Multiple vendor option for the same product is not supported.

If you want to, you can limit the number of products every vendor can add from the specific option that you find in Vendors permissions.

By default, the vendors products are visible in the main Shop page and listed on the vendor’s store page. If you want to hide the products from the main Shop page, the admin can simply enable the Product listings option from the → Store general options.

We also suggest you add YITH Vendor List widget to let your users simply switch from one vendor’s products to the other.

Skip admin review

Every new product can be directly published by the vendor or only after the administrator’s review and approval. If you prefer that vendors can publish new products and edit existing ones without the admin’s approval, you can edit these settings from the → Vendors permissions page.

These general settings apply to all vendors, but you can also override them from every single → vendor’s profile and make sure that for some vendors only you have to review products or changes.

Featured products

If enabled in the → Vendors permissions, both the administrator and the vendors will be able to set one or more products as “Featured”, so they will have more visibility.

Product tags and categories

If enabled in the → Vendors permissions, your vendors can also assign tags to their products. They can both use tags created by the admin and also create new tags that will be visible to them only.

For what concerns categories, instead, the vendor will be able to choose among the available store categories, but is not allowed to create new categories.

Coupons

Home > Premium version settings

If you want to, your vendors can create and manage coupon codes for their own products only. You can enable the Create coupons to be used on his/her products option from the → Vendors’ permissions.

Now, the vendor will be able to see a Coupons menu in his/her dashboard and create coupons. These coupons will be automatically enabled only for the products of the vendor who generated the coupon. Yet, the vendor can further filter the products it can be used on and use all the default coupon settings.

Your shop

Home > Premium version settings

In Your Shop menu, you find most of the vendor’s settings and information.

1. Vendor dashboard

First of all, we find the Dashboard with an overview on the vendor’s store, with info about:

total number of commissions
total commissions
pending commissions
paid commissions amount and
refunded commissions

These data can be filtered and compared by date range.

Below the commissions section and charts, you can also see a box with the top 5 products that generated the most sales for the current vendor.

2. Commissions

Here the vendor can see all his/her commissions, filter by status, date, product and export them into a CSV file (the export will automatically export the current view, so either all or filtered commissions).

To see the details of the commission, the vendor can simply click on the eye icon on the right and all the details will be opened in a modal window:

The commission status depends on the related order and suborder status. For more details about the commissions status, please, refer to this page. For orders, please refer to this page.

3. Store settings

From the store settings, the vendor can configure the store’s logo, header image, store name, slug, address, phone number, VAT, description, legal notes, social links.

Based on the address added here and if enabled by the admin from the → Store page > Store widgets settings, the plugin will automatically display a map with a pin on the vendor’s store position.

The same options can be updated by the admin from the vendor’s profile.

4. Payment info

From this tab, the vendor can enter his/her info related to the bank account and the PayPal email address that the admin will be able to use for manual payment of the payment commissions.

The admin will be able to see this details in the Vendor’s profile > Payment info.

5. Vacation, Shipping, Staff

If enabled by the admin in the Modules section, the vendor will be able to see additional tabs for each module. To learn more about each of them please refer to the following pages:

Reviews

Home > Premium version settings

If you want to, your vendors can manage the reviews of his/her own products. You can enable the Manage reviews from his/her customers option from the → Vendors’ permissions.

This will show a new Comments menu item on the left sidebar, where the vendor can see all reviews, reply, approve, unapprove, mark them as spam, edit or delete them.

Order management

Home > Premium version settings

On this page we will deal with everything related to orders in a multi-vendor environment:

Orders and vendor suborders
Vendors’ permissions regarding orders
Refunds
Order status synchronization
Orders from backend

Orders and vendors suborders

If you want to, your vendors can manage the orders with their own products and the related options. To enable all the orders and sub-orders options, please, refer to the following settings in the → Vendors’ permissions.

If you give your vendors the possibility to manage their orders, the plugin will automatically create one parent order visible to the admin and one suborder for each vendor with their own products only.

For example, if a customer purchases:

2 products of vendor A
1 product of vendor B

The plugin will generate a parent order with the 3 products and two suborders: one suborder with the products of vendor A and another one with products of vendor B. Each vendor will only be able to see his/her suborder, whereas the admin can see them all.

The vendor will be able to see the Orders menu where all his/her suborders are listed and can be edited and processed.

The vendor will be able to see here the product details, the commissions earned from this sale, edit the suborder details, status, and manage also refunds and coupons.

Other vendor permissions regarding orders

When enabling vendors to manage orders, you can also activate more options. Let’s see them below.

Refunds

Refunds for vendors will be managed through the standard WooCommerce system, so it’s a manually system that works exactly like for the admin. The only difference is that a vendor can only refund his/her own suborders.

So, to refund a suborder, the vendor can open it, click on the Refund button, select the amount to refund, and confirm.

Vendor refund — Refund in vendor’s suborder

This refund will also be visible to the admin in the parent order details. Commissions will be recalculated.

Refund in parent order — Refund in admin’s parent order

Email to customers

By enabling this option, vendors will be able to send automatic emails related to the order from the Order actions meta box in the order page.

Edit custom fields

If enabled, the vendor can edit also custom fields in the sub-order details.

See customer info in the order details

If enabled, the vendor will see the customer info section as highlighted below.

See payment info in the order details

If enabled, the vendor will see the payment info section as highlighted below.

See billing and shipping info in the order details

If enabled, the vendor will see the billing and shipping info section as highlighted below.

Order status synchronization

In the → Vendor permissions page, you will find two more options related to the orders.

Parent order and suborder synchronization: enable this option to synchronize all of the changes made to parent orders with the vendors’ individual suborders.

Suborder and parent order statuses synchronization: enable this option to update the parent order status when editing the suborder status.

How is the parent order status set when the suborder status changes?

If all suborders are set to completed, the parent order gets the completed status.
If all suborders are set to refunded, the parent order gets the refunded status.
If some suborders are completed and other refunded, the parent order status is set to completed.
If suborders have different statuses, the parent order gets the processing status.

Creating orders from the backend

An admin or shop manager can create orders from the backend and add products by one or multiple vendors. Based on that and after the order is created, the plugin will automatically calculate the vendors commissions and vendor suborders visible in the vendor’s Orders page.

Order from the backend before saving — Before saving: no commissions yet

Order from the backend after saving and with vendor commissions generated — After saving: vendor commissions generated

Please, note: vendors are not allowed to create orders from the backend.

General

Home > Premium version settings

From the Store & Product pages section, you will be able to edit many of the options of your vendors pages. Let’s start with the General ones.

Stores’ URL slug: enter the slug for the stores’ URL (e.g. “stores” will appear as follows in the vendor’s URL: http://yoursite.com/stores/vendor-name).

Label for “vendor”: enter the singular and plural name for “vendor”. This will replace all the occurrences on the frontend.

Hide products of stores in vacation mode: enable this option to hide the products that belong to the stores in vacation mode from the shop pages. For more details about the vacation mode, please, refer to this page.

Show the vendor’s name on shop pages: enable this option to show the vendor’s name below the products on the shop pages.

Show the vendor’s name on taxonomy pages: enable this option to show the vendor’s name below the products on the taxonomy pages, like category, tag pages and other taxonomies.

Vendor name colors: set the color for the vendor’s reference on the shop page, both the default value and on hover.

Product listings: enable this option to hide the products that belong to vendors from the store loop page. This way, vendor products will only be visible on the individual vendor pages.

Product page

Home > Premium version settings

From this tab, you can set up all the options related to the vendor’s product page and the shipping tab.

Show the vendor’s name on the product page: enable this option to show the vendor’s name below the product’s name on the single product page.

Show the vendor’s tab with the WooCommerce tabs: enable this option to show the vendor’s tab with the WooCommerce tabs on the single product page. Here you will see the Vendor description.

Vendor’s tab position:

Show the vendor’s tab as the first tab
Show the vendor’s tab after the WooCommerce tabs.

Vendor’s tab label: enter the title for the vendors’ tab.

Show the number of items sold: enable this option to show the vendor’s total number of sales on the product detail page.

Items sold label: enter the label for the “items sold” text. Use the %itemsold% placeholder to show the number of items sold. E.g. in the screenshot below we set it to %itemsold% orders.

Related products: choose here if showing the related products on the product page and which ones you want to show.

Don’t show the related products section
Show related products from the same vendor
Show related products from the whole shop

Shipping info tab

From this page, you can also change the name of the Shipping tab. This tab will automatically appear if the vendor’s shipping add-on is enabled and configured. To read more about the vendor’s shipping, please refer to this page.

Store page

Home > Premium version settings

From this tab, you will be able to configure all the options related to the vendors’ store pages. Let’s see all the options in detail.

Header style: choose the header style for the store page, below an example of the 3 available styles where the logo, the header, the vendor’s info and the description appear in different layouts.

Header size (px): set the size of the header image on the store page. Set it to zero to use the original image size (default: 0 px).

Header colors: set the colors for the header text and background.

Show default header image:

in all of the stores, vendors can’t upload a custom header image
only in stores that do not have a header image
never use the default header image

Upload default header image: upload here the default header image.

Show default logo:

in all of the stores, vendors can’t upload a custom logo
only in stores that do not have a logo image
never use the default logo image

Logo size (px): set the vendors’ logo size on the store page

Vendor info to show: choose the vendor’s info that will be shown on the vendor’s store page:

Description
VAT/SSN
Location
Phone
Store email
Total sales
Website
Reviews average rating
Social links
Store legal notes

VAT/SSN label: change the default VAT/SSN label according to your local standards.

Products list title: set a title to show before the products list on the vendor’s store page.

Store widgets

In the last two options, you can set up the Google Maps options to automatically show a the vendor’s store in a map based on the address added.

Google Maps API key: enter the API key. Click here to learn where to find this info.

Show Google Maps link: enable this option to add the “Show on Google Maps” link below the YITH Vendor Store Location widget.

Below an example of the vendor’s store page:

Other (T&C, Privacy, GDPR)

Home > Premium version settings

In the Other tab, you can handle all the options related to the Terms and Conditions and the Privacy Policy for vendors.

Terms & Conditions page: set the page for the Vendors’ Terms & Conditions by choosing among the existing ones or create a new page.

Privacy Policy page: set the page for the Vendors’ Privacy Policy by choosing among the existing ones or create a new page.

Ask vendors to accept the Terms & Conditions and Privacy Policy when updated: if enabled, every time the Terms & Conditions and/or the Privacy Policy are updated, vendors will have to read and accept them again.

If a vendor doesn’t accept the new policies you can choose whether to:

allow the vendor to keep selling anyway
disable the vendor’s selling feature immediately and until the policies are accepted
wait x days after the policies update and then disable the vendors’ selling feature until the policies are accepted.

Vendors will be informed through a warning message in their backend dashboard with a link to My account page > Terms of Service, where they can read the changes and accept the policies.

If you want to customize the message, you can create a custom announcement to show when the T&C or the Privacy Policy are not accepted. For more details about the custom announcements, please, check this page.

GDPR

Still on this page, you can also update the GDPR options.

When handling an account erasure request, you can optionally choose to remove the following information:

remove the vendor profile information
remove user ID in the vendor’s commissions
remove the vendor’s avatar and header image from media files

Export commissions in personal data export requests: enable this option to include the vendor’s commissions info when dealing with an an account’s personal data export request.

General information about payments

Home > Premium version settings

Whenever an order is placed, the customer will be able to pay all in one transaction, regardless of how many vendor products have been added to the cart. This guarantees that the customer experience at checkout is as flawless and quick as possible.

The only payment flow available is then from customer to admin’s account, and as a second step from admin to vendor’s accounts.

Can customer payments go right to vendors’ accounts, without passing from the admin’s account?

No, this is not possible. All payments will be done in a two step process:

customer to admin: the customer will send the payment to the admin’s connected payment account. Any payment gateway that is already enabled in WooCommerce will be available for payments from customers to admin.
admin to vendors (vendors’ payouts): these payments can either be done offline or through one of the supported gateways (manually or automatically).

Let’s see how manual and automatic vendors’ payouts work.

Manual Payment

It’s up to the global shop admin to manage manual vendors’ payouts.
To do that, you can open the Commissions page, filter your vendor commissions by Unpaid status, and filter by vendor.

Then, you can select all of them and bulk edit the status from the bulk actions. You can use any of the enabled gateways (enabled from → Commissions > Gateways).

If no gateway has been enabled, you can pay them offline (for example by bank transfer) and then change the status to Paid.

If you want to pay each single commission individually, you can find the same options in the commission’s actions, by clicking on the 3-dot button on the right.

Automatic Payment

To enable a default payment on checkout and make sure that vendors’ commissions are paid immediately and automatically, go to Commissions > Commission settings and enable the option called Pay commissions to vendors during checkout.

Then, select the gateway.

If no gateway is available, make sure you install the related plugin and enable it from Commissions > Gateways.

With any of the supported gateways, you will be able to issue payments to your vendors automatically and instantly during the checkout. The gateways are listed below:

Multi currency support

If your payment gateways support the multi currency option, this plugin will let you pay vendors’ commissions in every currency you have. Meaning that if you are running a multi currency store, commissions will be calculated and paid in the same currency they have been generated.

For example, if you are running a store in Euros and USD, your vendors will get commissions in Euros for orders placed and completed in Euros, and commissions in USD for orders placed and completed in USD.