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

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.

Product Listings

↑ Back to top

Your product (extension, integration, or theme) 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 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 WooCommerce.com.

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

Product icon: 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-croppe

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 Assets

Product name: The headline of your product – make sure this conveys the main purpose of your product.

Product icon: The icon is displayed next to the product title, as well as various other areas throughout the Marketplace: when the product is being added to the cart, some instances of the product card, or the in-app marketplace.

We recommend:

  • Uploading a 160x160px image.
  • Using logo images of your product, not your brand. For example, a Gmail extension would display a Gmail logo icon, not the Google logo.

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 icon and 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.
  • 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.

Requirements

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

Product Requirements on WooCommerce Marketplace

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.

WooCommerce

The most customizable eCommerce platform for building your online business.

  • 30-day money-back guarantee
  • Support teams across the world
  • Safe and secure online payment