Documentation

Product Attributes Guide

Create and manage product attributes like Size, Color, and Material to define product variants.

Watch: Product Attributes Setup Guide (6 min)

What are Product Attributes?

Product Attributes are characteristics that define different variations of a product. They allow you to create product variants without duplicating product data. For example, a T-shirt product can have attributes like Size (S, M, L, XL) and Color (Red, Blue, Green).

Product attributes list showing various attribute types
Manage all product attributes from a central location
When to Use Attributes

Use attributes when the same product comes in different variations that affect pricing, stock tracking, or customer selection. Examples: clothing sizes, phone storage capacity, beverage flavors.

How to Access Product Attributes

Navigate to Inventory > Product Attributes from the main navigation menu.

Navigation path to Product Attributes
Access Product Attributes from the Inventory menu

Supported Data Types

Product attributes support five different data types to accommodate various product characteristics:

Data Type Description Example Use Case
Text Free-form text input for any value Color names (Red, Blue, Custom), Material descriptions
Number Numeric values only Size (42, 44, 46), Weight (500, 750, 1000)
Date Date values Vintage year, Manufacturing date
Boolean Yes/No or True/False toggle Organic (Yes/No), Premium (Yes/No)
List Predefined list of allowed values Size (Small, Medium, Large), Storage (128GB, 256GB, 512GB)
List Data Type

When using the List data type, you must define the possible values. Users can only select from these predefined options when applying the attribute to product variants.

Creating an Attribute Type

Animated demo of creating a product attribute
Creating a new product attribute step by step
  1. Navigate to Product Attributes
    Go to Inventory > Product Attributes.
  2. Click "Create New"
    Open the attribute creation form.
  3. Enter Attribute Name
    Give the attribute a descriptive name that users will see.
    • Example: "Size", "Color", "Material", "Storage Capacity"
  4. Enter Attribute Code
    A unique identifier used internally by the system.
    • Example: "SIZE", "COLOR", "MATERIAL"
    • Use uppercase letters and underscores
  5. Select Data Type
    Choose from: Text, Number, Date, Boolean, or List.
  6. Define Possible Values (List only)
    If you selected List, enter the allowed values separated by commas or new lines.
    • Example: Small, Medium, Large, Extra Large
  7. Set Options
    • Is Required: Must have a value when applied to variants
    • Allow Multiple Values: Variants can have multiple values (e.g., multiple colors)
    • Display Order: Controls the order attributes appear in forms
    • Applies To: Optionally limit to specific product categories
  8. Save Attribute
    Click "Save" to create the attribute type.

Attribute Fields Reference

Product attribute creation form
The attribute form with all configuration options
Field Required Description
Attribute Name Yes Display name shown to users (max 100 characters)
Attribute Code Yes Unique system identifier (max 50 characters)
Data Type Yes Type of values: Text, Number, Date, Boolean, List
Description No Internal notes about the attribute (max 500 characters)
Applies To No Limit to specific categories (leave blank for all)
Is Required No If checked, variants must have this attribute
Allow Multiple Values No If checked, variants can have multiple values
Display Order No Order in forms (lower numbers appear first)
Possible Values Conditional Required for List data type only
Is Active No Inactive attributes are hidden from selection

Applying Attributes to Product Variants

Once you've created attribute types, you can apply them to product variants to create different versions of a product.

Product variant with applied attributes
A product variant with Size and Color attributes applied
  1. Open Product Details
    Navigate to Inventory > Products and open the product you want to modify.
  2. Go to Variants Section
    Find the "Variants" tab or section in the product details.
  3. Add or Edit Variant
    Create a new variant or edit an existing one.
  4. Select Attributes
    Choose the attribute types to apply and set their values:
    • Size: Large
    • Color: Blue
  5. Set Price/Weight Adjustments
    Optionally set adjustments based on attribute values:
    • Price Adjustment: Add/subtract from base price (e.g., +$5.00 for XL size)
    • Weight Adjustment: Modify weight (e.g., +0.2 kg for larger size)
  6. Save Variant
    Click "Save" to apply the attributes to the variant.

Price and Weight Adjustments

Attributes can automatically adjust the price and weight of product variants. This is useful when different sizes or configurations have different costs.

Price and weight adjustments based on attributes
Automatic price calculation based on attribute adjustments
Variant Base Price Size Adjustment Final Price
T-Shirt Small $20.00 $0.00 $20.00
T-Shirt Medium $20.00 +$2.00 $22.00
T-Shirt Large $20.00 +$4.00 $24.00
T-Shirt XL $20.00 +$6.00 $26.00

Use Case Examples

Example 1: Clothing Store

Attribute Data Type Possible Values
Size List XS, S, M, L, XL, XXL
Color List Red, Blue, Green, Black, White
Material List Cotton, Polyester, Blend

Example 2: Electronics Store

Attribute Data Type Possible Values
Storage Capacity List 64GB, 128GB, 256GB, 512GB, 1TB
RAM List 8GB, 16GB, 32GB
Color List Space Gray, Silver, Gold

Example 3: Food & Beverage

Attribute Data Type Possible Values
Flavor List Original, Vanilla, Chocolate, Strawberry
Size List 250ml, 500ml, 1L, 2L
Organic Boolean Yes/No

Best Practices

Do's
  • Use consistent naming conventions across attributes
  • Create attribute types before creating product variants
  • Use the List data type when you have a fixed set of options
  • Set Display Order to control how attributes appear in forms
  • Use the "Applies To" field to limit attributes to relevant categories
Don'ts
  • Don't delete attributes that are already used by product variants
  • Don't create duplicate attribute codes
  • Don't use Text data type when you have a fixed set of options (use List instead)
  • Don't change the data type of an attribute after it's been used

Troubleshooting

Cannot Delete an Attribute

  • Attributes in use by product variants cannot be deleted
  • First remove the attribute from all variants, then delete the attribute type
  • Alternatively, set the attribute to "Inactive" to hide it from selection

Attribute Not Showing in Variant Form

  • Verify the attribute is set to "Active"
  • Check if "Applies To" is limiting the attribute to a different category
  • Ensure you have the correct permissions to view product attributes

Required Permissions

To manage product attributes, users need the following permission:

  • Inventory.Products.View - View and manage product attributes

Next Steps

Products

Learn how to create products and apply attributes to variants.

Packaging

Configure multi-level packaging for your products.