View Product Page

Vendors list & new vendor

From the Vendors tab in the plugin settings, you will find multiple subtabs for your vendors. The first one is the Vendors list, so a page where you can find all vendors registered and add new ones.

Vendors list

The vendor ID column is hidden by default, but you can enable it from the Screen options if you need it.

Vendor ID

From this page you can also add a new vendor and edit the current ones.

Add a new vendor

The entire process of creating a vendor will be managed through a wizard in steps. Click on the + Add new vendor button.

Step 1 – Account info

Add new vendor - Account info

From this view, you can choose the user who is responsible for the store. You can either select an existing user or directly create a new user profile from this page.

Step 2 – Store info

New vendor - store info (1/2)
New vendor - Store info (2/2)

Here you can add all the vendor store info:

  • vendor profile image / logo (in the following image, it’s the logo over the header image)
  • vendor header image
  • store name
  • store slug
  • address and contact info
  • VAT number
  • phone number
  • store email address
  • store description
  • company legal notes

This is an example of how a vendor’s store page looks like:

Store page

Step 3 – Additional info

New vendor - Store social info

Here you can add the vendor’s social info:

  • Facebook
  • Twitter
  • LinkedIn
  • YouTube
  • Vimeo
  • Instagram
  • Pinterest
  • Flickr
  • Behance
  • Tripadvisor

Step 4 – Payment info

New vendor - Payment info

Here you can enter the vendor’s payment info that will be available in the vendor’s details.

  • Account name
  • IBAN
  • SWIFT / BIC
  • PayPal email

Step 5 – Options

New vendor - options

Here you can override some of the general options related to this specific vendor.

Commission base: choose whether to use the default commission rate (that you can set up from the Commissions settings page) or set a custom one for this vendor.
For example, you may want to override the default commission settings that is set to 80% and make sure that this vendor gets a 50%.

Skip admin review: enable this option to allow this vendor to publish new products without the admin’s review. This option overrides the default one set on the → Vendors permissions page.

Allow vendor to set featured products: enable this option to allow this vendor to manage featured products and set some of his/her products as featured.

Edit a vendor’s account details

Once your vendor is created you can edit some of the details at any time by simply clicking on the pencil icon.

Additionally, you can also see a new Staff tab, where you see all the staff members added by the vendor to his/her shop. The admin cannot change these settings, but the vendor can do that from the Vendor staff module.

Edit vendor - Vendor's staff

Vendor registration

From this tab, you will be able to set up the Vendor registration page with all its options.

Vendor registration

Vendor registration page: select the page that will contain the vendor registration form. Please note: if you select any page different from the default one [Become a Vendor], you’ll need to insert the following shortcode on that page: [yith_wcmv_become_a_vendor].

Example of a Become a seller page with the registration form

Registration fields

Registration fields: here you can enable/disable the default fields of the registration form, but you can also add new ones.

To add a new field, click on Add field: this will open a modal window, where you can set up all the following options.

Add registration field
  • Name: this is the name of the field, the one you will see in the registration form list on this page and it’s a mandatory field.
  • Type:
    • Text
    • Email
    • Phone
    • Textarea
    • Radio
    • Checkbox
    • Select
    • Multiselect
    • Country
    • State
  • Label: this is the name of the field as displayed to users on the frontend.
  • Class: add here one or more CSS classes, separated with commas, to customize this field.
  • Placeholder: enter here the placeholder text for this field. (available only for Text, Email, Phone, Textarea, Select, Multiselect types).
  • Connect to: select one of the default fields here if you want to connect this field to one of the default ones visible in the vendor’s profile page.
  • Options: here you can enter the various select options (this is only visible for Radio, Select and Multiselect types): add the name as displayed on the frontend in the label and
    field options
  • Position: choose whether the field will appear on the left side (first), right side (last) or will cover the entire width of the form (wide).
  • Required: choose whether to make this field is a mandatory field.

Let’s see more options related to this page:

Vendor registration options

Vendor registration on My Account page: enable if you want registered users to be able to register a vendors from My Account page.
Note: you have to allow registration on the My Account page from WooCommerce > Settings > Accounts & Privacy.
By clicking on the “Register as a vendor” checkbox, the vendor registration form will be displayed, as in the following screenshot.

Vendor registration in My Account

Enable vendor accounts automatically: this option automatically enables vendors after registration. If you disable it, the administrator must enable each vendor account manually.

Add the Terms & Conditions to the registration form: enable to show he Terms & Conditions checkboxes in the registration form.

Add the Privacy Policy to the registration form: enable to show the Privacy Policy checkbox in the registration form.

Vendors permissions

From this page, you will be able to control many of the options related to what the vendors can do from their own accounts.

Vendors permissions 1

Enable the advanced editor for the vendors’ descriptions: enable this option to allow vendors to use an advanced editor for their stores’ descriptions. Please, check this page for more details about how vendors can edit their store info.

Enable the media button in the text editor: enable this option to allow vendors to use the media button in the advanced editor.

Standard and advanced editor

Limit the number of products: enable to set the maximum number of products a vendor can publish. This applies to all vendors. If you want to differentiate and let vendors subscribe to different plans, take a look at the integration with YITH Membership plugin, more details here.

Each vendor can sell a max. of x products: set here the maximum number of products a vendor can publish.


Admin’s review on vendor products

The following two options allow the admin to review what the vendor publishes a new product or edits an existing product and can be managed separately.

When a vendor creates a product:

  • It can be published directly, without the admin’s review
  • The product will remain pending until the admin approves it
    Note: you can override this option for each specific vendor by editing the vendor’s profile as explained here.

Force the “Skip admin’s review” option for all vendors: force the option to skip the admin’s review to publish products for all vendors. Note: the global rule can be overridden inside each vendor’s profile.

When a vendor edits a product:

  • the product can be updated without the admin’s review
  • the product will remain pending until the admin approves it
    Note: you can override this option for each specific vendor by editing the vendor’s profile as explained here.

Store and orders permissions

Regarding his/her store, a vendor can:

  • create coupons to be used on his/her products. For more details, please, refer to this page.
  • edit the store slug from the → store configuration.
  • assign tags to products. For more details, see → product management.
  • set products as “featured” to highlight them. For more details, see → product management.
  • import products by using WooCommerce import tool.
  • export products by using WooCommerce export tool.
  • manage reviews from his/her customers. For more details, refer to this page.

Regarding his/her orders, a vendor can:

  • manage orders
  • manage refunds
  • send emails to the customers
  • edit custom fields
  • see customer info in the order details
  • see payment info in the order details
  • see billing and shipping info in the order details

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

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

For more details about the order management and all the above options, please, check this page.

Vendor’s view

Every vendor will be able to access his/her dashboard with all their details about their sales, commissions, orders and profile.

Once their vendor profile is enabled (please, refer to this page to learn how to do that), they can simply log in with their username or email address and they will be able to access their backend dashboard that looks like this:

vendor dashboard

As you can see, you will find a limited number of menus on the left side, based on what the admin has enabled:

  • Media: this is the standard media library, but the vendor will be able to only see his/her media file
  • Comments: this is where the vendor can see and manage reviews of his/her products. For more details, please, visit this page.
  • Products: this is where the vendor can find his/her own products. More details here.
  • Coupons: this is where the vendor can find his/her own coupons. More details here.
  • Your Shop: this is where the vendor can edit the details of his/her shop, edit logo, description etc. More details here.
  • Orders: this is where the vendor can find and edit his/her suborders. More details here.
  • Profile: this is where the vendor can edit his/her default user profile.

Product management

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.

Products
Products – Vendor view

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…

Products – Admin view

… 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:

Bulk edit 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.

Limit products

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.

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.

Featured products
Set featured product

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.

Assign tags
Product tags

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.

Product categories

Coupons

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.

Vendor store 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.

Coupons

Your shop

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.

Vendor dashboard

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).

Vendor's 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:

Vendor commission details

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.

Store settings

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.

Payment info in vendor's profile

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

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.

Vendor store 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.

Comments reviews

Order management

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

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.

Orders 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.

Orders and suborders

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.

Vendor order details

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.

Vendor can email customer

Edit custom fields

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

Edit custom fields

See customer info in the order details

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

Customer info in order details

See payment info in the order details

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

Payment info in order details

See billing and shipping info in the order details

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

Shipping and billing info in order

Order status synchronization

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

Order sync

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.