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

Logo: 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, so we recommend an image size of 374x192px to account for retina displays.  

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

Dedicated Product Page ↑ Back to top

Example of an Extension:

Example of a Payment Gateway:

Log into WooCommerce.com.

Go to: WooCommerce > Products > Add Products.

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

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

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


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

Back to the top