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.


  • 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

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

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

Product Card

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 that pulls through should be your logo.

  • Upload it to Product Data > Woo Product Data > Extension Logo Path
  • Use a version of your logo on a transparent or white background. If you don’t have a logo, the product name will appear
  • The space for the logo is 187x96px — we recommend an image size of 374x192px to account for retina displays
  • If you use a larger image it will get auto-cropped

How to add logo to your product

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 an Extension:


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.

WooCommerce - the most customizable eCommerce platform for building your online business.

Back to the top