1. Documentation /
  2. Writing Product Pages and Marketing Content

Writing Product Pages and Marketing Content

Your product listing on Woo.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.


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

Product Listings

↑ Back to top

Your product (extension, integration, or theme) will be listed in three places on Woo.com:

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

On occasion, your product may be pulled into a Collection that appears on the Marketplace Homepage. Collections are 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, displayed in the category listing, the search results page, and filtered views on Woo.com.

Product name

↑ Back to top

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

  • 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

Product icon

↑ Back to top

The product icon is the key visual element in your product card. The image should be:

  • The logo of your product, not your brand. For example, a Gmail extension would display a Gmail logo icon, not the Google logo.
  • A 160x160px image file, JPG or PNG.
    • The image is displayed at 80x80px, so please mind legibility. We recommend logos/symbols over text that would be too small to read.
    • Please keep the icon content inside the 112Ă—112 area. This region of the image is unlikely to be hidden from view.
    • We use the border-radius property to define the radius of the icon’s corners, so please don’t add rounded corners to your image.

Upload it under Product Data > Woo Product Data > Product Icon

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.

Highlight card background color 

The highlight card background color sits behind the product icon and is applied to special placements across the Woo.com (see the example below from the Marketplace homepage):

Provide a hex color code under Product Data > Woo Product Data > Highlight card background color

Short description

↑ Back to top

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 Woo.com.
  2. Go to: Vendor Dashboard > Products > All Products.
  3. Click on the extension you want to edit
  4. Click Edit product page in the upper right

Example of a Product Page:

Product page elements

↑ Back to top
  • Product header image: The header image can add a striking visual element to the product page. We recommend:
    • Uploading an image with a size of 864×270 or 1728×540 pixels with a transparent background to be used over a light background. 
    • Using a header image strategically (it is not required) and not when you have a featured video.
    • To add a product header image, go to Product data > Woo product data
  • 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.
    • Avoid including videos or screenshots in-line unless absolutely necessary.
  • Highlighting example stores or use cases: You may want to highlight a store using your product to showcase how 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. Alternatively, you can use general use-cases.
  • Product 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. Attributes can have a meaningful impact on your sales as they impact search and filtering. To add attributes scroll to Product Data > Attributes.

  • Requirements: Product requirements can be added under the Woo Product Data tab –
Product Requirements on WooCommerce Marketplace