Flash sale: Get up to 30% off themes and extensions. Ends April 26 at 3 pm UTC. Shop the sale.
  1. Documentation /
  2. Managing products on the Woo Marketplace

Managing products on the Woo Marketplace

Developers selling on the Woo Marketplace can edit product pages, access information like usage data and sales, and manage reviews for their products.

Editing a product page

↑ Back to top

Most of the work for managing products can be done from the Products screen in the Vendor Dashboard. To get there:

From there, you can see information about usage, upload a new version or edit the product page.

For more on how to make the most of your product pages, read the guidelines for writing marketing content.

Adding or editing documentation

↑ Back to top

To review, edit or add documentation, go to the Documentation tab.

For more on how to format documentation, read the guidelines.

Uploading new versions

↑ Back to top

Before uploading a new version of your extension, it is important to ensure that it passes all QIT quality standards. You can easily run these checks from your partner dashboard by selecting the Quality Insights menu option. To learn more about the types of tests and how to run them, please refer to the provided documentation.

You can upload the updated version after your extension passes all QIT checks.

Select the Versions tab. You’ll see all the versions you’ve previously uploaded, including highlights about what was in each version.

Select Add Version to upload an updated version, then:

  • Select the .zip file you want to upload from your computer
  • Add the version number
  • Click Submit new version

Once submitted, we will run basic tests on the uploaded file. All Vendor Admins will receive email notifications throughout the process, including:

  • Confirmation: Vendor Admins will get an email when a new version is submitted, confirming that it is in the queue. No action is needed here.
  • Rejected: If a version fails any part of our automated testing, Vendor Admins will receive an email letting them know, including the specific error. Developers should try to resolve the error and submit a new version when ready.
  • Live: If a version passes automated testing, it will be automatically deployed and made available to customers. No action is needed.

Formatting the changelog

When uploading a version, WooCommerce.com looks for a specific format for the changelog. The name of the file should be changelog.txtand it should have the following formatting:

*** Product Name Changelog ***

yyyy-mm-dd - version x.x.x
* Item one
* Item two

The date format, the space between the -, and the word version are all important there.

Common errors

If an upload fails, there are a few common errors you should check first.

  • The name of file: WooCommerce.com looks for a specific name for your .zip file and the main folder within it. You’ll see the expected name when you try to upload a product:
expected file name for WooCommerce Marketplace
  • That a changelog is present: A file named changelog.txt must be present to serve as a record of what’s changed from version-to-version.

Understanding product sales

↑ Back to top

Vendors have access to reports on how their products are performing, including:

  • Earnings: New sales, renewal sales, and refund amount.
  • Commissions: The amount the Vendor earns from net product sales – net revenue is defined as revenue received from extension purchases minus refunds, chargebacks, disputes, discounts, and affiliate fees
  • Subscriptions: Total active subscriptions, including new and renewing this month, as well as refund rate and renewal rate.

To find this information, log in to the Vendor Dashboard and go to Products > Sales Report.

Sales Report in WooCommerce Marketplace Vendor Dashboard

Reviewing feature requests

↑ Back to top

Each product sold on the WooCommerce.com Marketplace has a dedicated page where customers can submit feature requests.  Learn more about the customer experience with the Feature Request Portal.

In the vendor dashboard, you’ll see a list of all feature requests for your products in the marketplace, along with number of votes and publish date.

Screenshot on 2022-09-27 at 11-51-47.png
You will be able to change the status of these feature requests:


  • Open: This is the first status after the feature request is submitted and approved. It is not yet acted upon.
  • Planned: You intend to build this feature.
  • In Progress: You are currently working on this feature.
  • Completed: You have completed the feature.
  • Rejected: You will not implement this feature.

Seeing reviews

↑ Back to top

Customers who have purchased a product may leave a rating and review. When there are a minimum of 3 ratings, reviews are shown on the product page, and ratings are visible on the product page, category page, and in search results. Read our guidelines around ratings and reviews.

Whether reviews are public or not, Vendor Admins can see reviews for their own products by logging in to the Vendor Dashboard and then going to Feedback > Reviews.

Annotation on 2022-09-25 at 10-08-57.png