---
title: 'Let your products speak: Define properties | Shopware Community Hub'
description: >-
  This learning unit will guide you through defining and customizing product
  properties to optimize your storefront experience.
canonical_url: 'https://hub.shopware.com/learn/unit/user-properties'
---

# Let your products speak: Define properties

<LearningObjectives>

- Understand the importance of product properties for customer experience and filtering.
- Navigate to the Properties section within the Shopware admin.
- Create new product properties such as Body Finish and Neck Material.
- Add meaningful values to properties, including colors and descriptive labels.
- Assign created properties and values to specific products.
- Verify that properties appear correctly on the product detail page and storefront filters.
- Recognize the foundational role of properties in preparing for advanced product variants.

</LearningObjectives>

# Let your products speak: Define properties

Imagine a customer browsing your music shop - **Strum & Co.** for their dream guitar. Beyond the product name, they want to know more details like:

- **What's the finish?**
- **What material is used?**

These properties make all the difference in helping a customer filter and choose products from the lot.

In your online shop, well-defined product properties will:

- Enhance search and filtering options for your customers.
- Highlight key features of each product for easier comparisons.
- Lay the foundation for advanced product variants.

Let's dive in and give your guitars the detailed spotlight they deserve.

## Scenario: Bring the **American Ultra Stratocaster** to Life

Your guitar currently only has a name and a price. Let's enrich its identity by adding:

- **Description**: A short context about the product.
- **Body Finish**: Example values could be *Fiesta Red* or *Olympic White*.
- **Neck Material**: Key materials like *Alder* or *Roasted Maple*.

These properties will make your products visually and functionally distinct, offering clarity to your customers. Ready? Let's set them up!

## Adding Product Properties

<ShopdevInstance plugin="lp15" step="DoNotDisplay" plan="rise" />

### Step 1: Create a new Property

1. Navigate to **Catalogues -> Properties** in the Shopware admin.
2. Click **Add Property** button on the top-right.
3. For the first property, enter these details:
   - **Name**: Body Finish
   - Leave other fields as default (they're optional for now).
   - Click **Save**.

![Properties basic information](./assets/properties.jpg)

You've created the property, but it needs values. Let's add some!

### Step 2: Add Property Values

1. Inside the *Body Finish* property page, scroll down to the **Property Values** section.
2. Click **Add Value** and enter the following:
   - **Name**: *Fiesta Red*
   - **Color**: Select a bold red.
   - Click **Save**.

3. Add another value:
   - **Name**: *Olympic White*

4. Repeat the process for your second property: *Neck Material* with:
   - Values: *Alder* and *Roasted Maple*

After saving, the properties overview page will display the new properties with their values:

![Properties Overview](./assets/properties_values.jpg)

### Step 3: Assigning properties to the Product

Now that your properties are ready, let's assign:

1. Go to **Catalogues -> Products** and select the **American Ultra Stratocaster**.
2. Navigate to the **Specifications** tab.
3. Under **Properties** section, click **Configure properties** and assign the following:
   - For **Body Finish**, choose *Fiesta Red*, click **Save**.
   - For **Neck Material**, select *Roasted Maple*, click **Save**.

   ![Properties Overview](./assets/property_config.jpg)

4. Click **Save** again to confirm the product changes.

## Scenario checkpoint: See the results

Head to your storefront and refresh the **American Ultra Stratocaster** product page. Check for the following:

1. **Product Detail Page**: The properties should be displayed below the product description.

   ![Properties Overview](./assets/simple_product_details.jpg)

2. **Filters in the Product Listing**: Navigate to the main category (e.g., **Home**). On the left-hand side, you'll see filters like **Body Finish** and **Neck Materials**.

   ![Properties Overview](./assets/property_storefront_display.jpg)

These properties enhance product details and guide customers to find exactly what they're looking for.

## Activity: Expand your product properties

Want to take it further? Add more properties to diversify your catalog:

1. Create properties like **Pickup Type** (*Single Coil* or *Humbucker*) or **Weight** (*Light* or *Medium*).
2. Assign them to other guitar products.

## Final thoughts

Refer to [properties](https://docs.shopware.com/en/shopware-6-en/products/properties?category=shopware-6-en/catalogues) section to understand that they are more than just labels. They are the backbone of clear product descriptions and intuitive storefront filters. They'll also play a crucial role in creating **product variants**, which we'll cover in an upcoming unit.