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.

Managing products

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

• Log in to the Vendor Dashboard
• Go to Products > All Products
• Select the product you want to work on

This will take you to the product overview, which includes:

• Name: The name of the product, as it appears on the product page. Note that this may be different from the product slug or URL.
• Single-site subscription: The base price for a single-site subscription of the product.
• Last updated: The date when the latest version was uploaded, and a link to the changelog.
• Categories: The categories the product is listed under.
• Short Description: The tagline for the product, more on this here.

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

Editing product pages

To edit a product page, select Edit Product Page from the product overview.

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

Adding or editing documentation

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

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

Understanding product statistics

In the product overview, the Statistics tab includes usage information to help developer know what versions of relevant technologies are used with a given product.

These statistics comes from the WooCommerce Tracker and are based on stores that allow for usage tracking. Developers can use this information to make decisions about what versions of WordPress, WooCommerce and PHP to support.

Uploading new versions

To upload a new version, 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 notification 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:

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.

The changelog format – more on what this should look like here.

Understanding product sales

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

• Earnings: New sales, renewal sales, and refund amount.
• Commissions: The amount earned by the Vendor from all sales.
• 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.

Reviewing feature requests

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.

Seeing reviews

Customers who have purchased a product may leave a rating and review. When there are a minimum of 10 ratings, reviews are show 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.