1. Documentation
  2. Plugins
  3. WooCommerce
  4. WooCommerce Marketplace
  5. Content, Product Pages, and Documentation

Writing Product Pages and Marketing Content

Your product listing on WooCommerce.com plays a critical role in explaining why your product is the right fit and getting a customer to choose to purchase.

When creating and editing product listings, take time to think about what customers want to know, what makes your extension stand out, and what information customers need to make the right choice.

Objective ↑ Back to top

  • Showcase how features can add value for developers or store owners.
  • Persuade potential customers to choose this extension over comparable options.

Product pages should explain why an extension is a good fit, not how specific elements work – technical details are best saved for documentation.

Extension Listings ↑ Back to top

Your extension will be listed in three places on WooCommerce.com:

  • A product card across category and search pages
  • A dedicated product page
  • A dedicated Vendor page

On occasion, your extension may be pulled into a Collection that appears on the Marketplace Homepage. Collections our curated by the WooCommerce team and cannot be requested.

Product Card ↑ Back to top

The product card is your first impression and first chance to win over customers, displaying in category, search results and filtered views on WooCommerce.com.

WooCommerce Marketplace Product Card

Product name: Choose a name that explains what your product does or why it’s useful.

  • Brief – No more than three words
  • Scannable – Easy to understand
  • Unique – Drives clicks to read more and makes it easier to find the listing via search
  • Customer-focused – Use your customers words rather than your own

Image: The image must be your logo or your product’s logo.

Upload it to Product Data > Woo Product Data

  • There are three options for your product cards:
    • Regular Card Product Logo: Provide a logo with transparent background with a minimum of 374 x 192 pixels
    • Highlight Card Product Logo: Provide a light logo with transparent background with a minimum of 374 x 192 pixels for a light background
    • Highlight card background color: Provide a Hex color code to be used as the background for your logo. 

Example of Logo with Hex Color background:

Example of a Logo without Hex Color background:

If a non transparent image is used, please be sure to update the background color accordingly. If you use a larger image it will get auto-cropped.

Short description: Limit to a one-sentence description of what your product does.

Dedicated Product Page ↑ Back to top

To edit a product page:

  1. Log into WooCommerce.com.
  2. Go to: Vendor Dashboard > Extensions > All Extensions.
  3. Click on the extension you want to edit
  4. Click Edit product page in the upper right

Example of a Product Page:

Product name: The headline of the Dedicated Product Page is your product name, without a logo –  make sure this conveys the main purpose of your product.

Videos and screenshots: The most prominent section of your product page features videos and screenshots uploaded to the Product Gallery. Videos default to being first in the gallery, and images go in order.

We recommend:

  • Including a video of 1:30 to 2 minutes, with a 16×9 aspect ratio (2:35.1 also works), and 1920 x 1080 resolution (1280 x 720 resolution is fine).
  • Uploading 3 to 5 screenshots of 1200px wide x 684px high. Higher resolution images will also work, as long as they keep a 16:9 aspect ratio.
  • Including both what a product looks like on the front end and what settings or options are available on the back end

To add a video, scroll to Product Data > Feature Video and enter the embed code.

embed video on WooCommerce Marketplace

Long description: This large text field gives you the most opportunity to highlight what’s valuable, special and great about your extension.

We recommend that you:

  • Start with your main value proposition in H2.
  • Follow with a paragraph sharing an overview about your extension.
  • Highlight your most important features in subheadings (H3), followed by 1-2 paragraphs giving more details about that feature.
  • Finish with a section on technical details, including a bulleted section. Since many WooCommerce.com customers are developers, they look for this detail when making a purchase decision.
  • Avoid including videos or screenshots in-line unless absolutely necessary.

Product Attributes

Scroll to: Product Data > Attributes.

Product attributes allow you to define other characteristics that might be relevant for customers, like what countries a payment gateway works in or what extensions your extension is compatible with. While not visible on the product page, attributes can have a meaningful impact on your sales as they impact search and filtering.

You can set these under in the product page editor under Attributes.


Product requirements can be added under the Woo Product Data tab –

Product Requirements on WooCommerce Marketplace

Highlighting example stores

You may want to highlight a store using your extension to showcase how your extension can be used. If you do so, we recommend that you get explicit permission from the store before including any images or logos on the product page or any other marketing.


The most customizable eCommerce platform for building your online business.

  • 30 day money back guarantee
  • Support teams across the world
  • Safe & Secure online payment