Product Page – Content and Assets

This document is designed to walk you through each step of editing your product page, detailing the assets you’ll need and offering a few recommendations to maximize its effectiveness. Whether you’re introducing a new product or refining an existing listing, the success of your page hinges on a clear, engaging, and user-friendly presentation.

Editing the Product Page

↑ Back to top

From there, you can see information about usage, upload a new version or edit the product page.

Product icon

↑ Back to top

The product icon is the key visual element in all occurrences of your product in the Woo Marketplace.

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 160 × 160px 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 × 112px 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.

Short description

↑ Back to top

Keep it short and powerful. Besides the product page, the short description is also used in the product card, or the excerpt Google uses in the search results page.

To add/edit the short descriptions, when editing a product, scroll down to the bottom of the screen.

The Gallery

↑ Back to top

The media gallery gives you the opportunity to put your product in its best light. We recommend using it for as much as possible.


↑ Back to top

The images should be:

  • 896 × 550 px or larger

To upload images, use the native WooCommerce gallery in the product editor, as described in the image above, and always start with the Featured Image.


↑ Back to top

The gallery supports one embeddable video per product (e.g. YouTube, Vimeo). If there’s a video attached, it will always show as the first item in the gallery.

To embed a video, when editing a product, scroll down to the Product Data section and click the “Featured Video” tab. Paste in your video’s embed code and Update.

Product description

↑ Back to top

When creating product pages, it’s essential to communicate effectively, ensuring the content is accessible and engaging for everyone. The description gives you the most opportunity to highlight what’s valuable about your product from a customer’s perspective. Here are a few recommendations to help you get the best of it:

  • Focus on Sales, Not Specs ― Design your description to highlight key benefits, keeping technical details for documentation. This approach helps customers understand the value of your product without getting bogged down by complexity.
  • Start With Top Benefits ― Lists are not only easy to scan but also make your most compelling selling points stand out, ensuring they’re memorable and immediately accessible. A 3-5 points list format allows users to quickly understand the unique advantages your product delivers.
  • Explain Like I’m 5 ― Aim to present your products in a way that anyone, even a beginner, can understand. Simplify your explanations without compromising the message, making sure concepts are broken down into fundamental, easy-to-grasp ideas.
  • Sell the Hole, Not the Drill ― Remember, customers are looking for solutions, not specifications. Start with the benefits your product offers, then mention the features. For instance, instead of leading with “This phone case is made of carbon fibers,” highlight “Protect your phone from any fall with our ultra-durable case.” It’s about solving problems, not listing specifications.
  • Simple and Clear Language ― Use plain, straightforward language that avoids industry jargon and complex terms. Break down elaborate concepts into simple explanations. This approach makes your content accessible to beginners and experts alike, ensuring everyone understands the value of your products.
  • Visual Aids and Examples ― Leverage diagrams, screenshots, and examples to illustrate your points. Visual aids can turn abstract concepts into tangible ideas, making them easier to grasp. Leave the screenshots showcasing the settings screens or other technical parts for the documentation.
  • Empathy and Understanding ― Acknowledge the challenges users might face, offering reassurance and support to boost their confidence in using your products.
  • Include FAQs ― What are the most common questions or concerns coming in as pre-sale questions? Try to respond to those in a Questions and Answers section at the bottom of the page.

Product Attributes

↑ Back to top

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.

The attributes will be displayed on the right sidebar and can have a meaningful impact on your sales as they impact search and filtering. To add attributes scroll to Product Data > Attributes.

Listing Requirements

↑ Back to top

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

Product Requirements on WooCommerce Marketplace

Highlight card

↑ Back to top

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

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

Product Name

↑ Back to top

Changing a product’s name

To have the name of a product changed, please get in touch with the Woo Marketplace team via the Vendor Dashboard.

Naming Guidelines

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 Price

↑ Back to top

To have the price of a product changed, please get in touch with the Woo Marketplace team via the Vendor Dashboard.