​

Managing Product Attributes

Product attributes are the custom fields that define what information you can store about your products. From basic details like color and size to complex specifications and technical data, attributes give you the flexibility to capture exactly the product information your business needs.

​

What Product Attributes Are

Product attributes are custom fields that allow you to:

• Store Product Information: Capture specific details about your products
• Standardize Data: Ensure consistent information across your catalog
• Enable Filtering: Help customers find products based on specific criteria
• Support Integrations: Map data to different platforms and marketplaces
• Improve Search: Make products discoverable through detailed specifications
• Enhance AI: Provide structured data for better AI-generated content

​

Understanding Attribute Types

​

Text Attributes

Text: Single-line text input

• Best for: Product names, short descriptions, model numbers
• Example: Brand name, SKU, product title
• Validation: Character limits, pattern matching

Text Area: Multi-line text input

• Best for: Longer descriptions, detailed specifications
• Example: Product features, care instructions
• Validation: Word count limits, formatting rules

​

Numeric Attributes

Number: Whole numbers only

• Best for: Quantities, counts, ratings
• Example: Number of pieces, warranty years
• Validation: Min/max values, required ranges

Decimal: Numbers with decimal places

• Best for: Measurements, prices, weights
• Example: Dimensions, weight, price
• Validation: Precision settings, value ranges

​

Date and Time Attributes

Date: Date selection

• Best for: Release dates, expiration dates
• Example: Launch date, best before date
• Validation: Date format, range restrictions

DateTime: Date and time selection

• Best for: Timestamps, scheduled events
• Example: Sale start time, event datetime
• Validation: Time zone handling, format settings

​

Selection Attributes

Select: Single choice from predefined options

• Best for: Categories, sizes, colors
• Example: Size (S, M, L, XL), Color (Red, Blue, Green)
• Validation: Required selection, custom options

Multi-Select: Multiple choices from predefined options

• Best for: Features, compatibility, tags
• Example: Compatible devices, available features
• Validation: Min/max selections, option limits

​

Special Attributes

Boolean: True/false toggle

• Best for: Yes/no questions, feature availability
• Example: Waterproof, wireless, eco-friendly
• Validation: Default values, required settings

Color: Color picker

• Best for: Product colors, theme colors
• Example: Primary color, accent color
• Validation: Color format, palette restrictions

Image: Image upload

• Best for: Product photos, diagrams
• Example: Main image, detail shots
• Validation: File size, format restrictions

File: File upload

• Best for: Documents, manuals, certificates
• Example: User manual, warranty document
• Validation: File type, size limits

​

Creating Product Attributes

​

Basic Attribute Creation

1. Navigate to Product Attributes: Go to the Product Attributes page
2. Click “New Attribute”: Use the green button to start creating
3. Fill Basic Information: Provide label, code, and type
4. Set Properties: Configure requirements and visibility
5. Save Attribute: Create the attribute for use in products

​

Attribute Configuration

Basic Information:

• Label: Human-readable name displayed in forms
• Code: Technical identifier used in systems and APIs
• Type: Data type that determines input method
• Group: Optional organization into logical groups

Properties:

• Required: Must be filled for all products
• Unique: No two products can have the same value
• Filterable: Can be used to filter product lists
• Searchable: Included in product search functionality
• Visible: Shown in product displays and forms

​

Advanced Settings

Validation Rules:

• Text Length: Minimum and maximum character limits
• Number Ranges: Acceptable value ranges for numeric fields
• Pattern Matching: Regular expressions for format validation
• Custom Messages: Error messages for validation failures

AI Enrichment:

• AI Enrichable: Allow AI to suggest or generate values
• Confidence Threshold: Minimum confidence for AI suggestions
• Review Required: Human review needed for AI-generated content
• Word Limits: Min/max word counts for text generation

Data Cleaning:

• Trim Whitespace: Remove extra spaces automatically
• Remove Empty: Clear out empty or meaningless values
• Normalize Case: Standardize text capitalization
• Format Standardization: Apply consistent formatting rules

[Screenshot of the attribute creation form with all options]

​

Organizing Attributes with Groups

​

What Attribute Groups Are

Attribute groups help you organize related attributes together for:

• Better Organization: Group related fields logically
• Improved User Experience: Present attributes in organized sections
• Easier Management: Manage related attributes as a unit
• Cleaner Interfaces: Reduce clutter in product forms
• Consistent Structure: Maintain organization across products

​

Creating Attribute Groups

1. Navigate to Attribute Groups: Go to the Attribute Groups page
2. Click “New Group”: Start creating a new group
3. Provide Group Details: Name, code, and description
4. Select Attributes: Choose which attributes belong in this group
5. Set Order: Arrange attributes within the group
6. Save Group: Create the organized group structure

​

Group Organization Strategies

By Product Category:

• Electronics Group: Screen size, processor, memory
• Clothing Group: Size, color, material, care instructions
• Food Group: Ingredients, nutrition facts, allergens

By Data Type:

• Specifications Group: Technical measurements and details
• Marketing Group: Descriptions, features, benefits
• Logistics Group: Shipping info, dimensions, weight

By Usage:

• Customer-Facing Group: Information shown to customers
• Internal Group: Data for internal use only
• Platform-Specific Group: Data for specific sales channels

​

Managing Your Attribute Library

​

Attribute Maintenance

Regular Review:

• Check which attributes are actually being used
• Remove or archive unused attributes
• Update validation rules based on data quality
• Refine groups based on usage patterns

Performance Optimization:

• Monitor which attributes slow down forms
• Optimize validation rules for speed
• Review AI enrichment performance
• Update cleaning rules based on data issues

​

Data Quality Control

Validation Monitoring:

• Track validation errors and failures
• Identify common data entry mistakes
• Refine validation rules to prevent errors
• Provide clear guidance for data entry

Consistency Checks:

• Ensure similar products use consistent attributes
• Check for duplicate or overlapping attributes
• Verify attribute groups make logical sense
• Maintain naming conventions across attributes

​

Team Collaboration

Access Management:

• Control who can create and modify attributes
• Set permissions for different user roles
• Coordinate attribute changes across teams
• Maintain documentation for team reference

Change Management:

• Plan attribute changes carefully
• Test changes before applying to all products
• Communicate changes to relevant team members
• Document reasons for attribute modifications

​

Integration with Other Features

​

AI Content Generation

Structured Data for AI:

• Well-defined attributes provide context for AI
• Consistent data improves AI content quality
• Attribute relationships help AI understand products
• Clean data leads to better AI suggestions

Enrichment Workflows:

• AI can suggest values for enrichable attributes
• Confidence thresholds ensure quality control
• Review processes maintain accuracy
• Automated cleaning improves data consistency

​

Platform Integrations

Marketplace Mapping:

• Map attributes to platform-specific fields
• Handle different naming conventions
• Manage platform-specific requirements
• Maintain data consistency across channels

Export and Import:

• Use attributes to structure export data
• Map imported data to appropriate attributes
• Validate data during import processes
• Maintain attribute consistency across systems

​

Product Management

Bulk Operations:

• Update attribute values across multiple products
• Apply validation rules consistently
• Use attributes for product filtering and selection
• Maintain data quality during bulk changes

Category Management:

• Link attributes to specific product categories
• Show relevant attributes based on product type
• Hide irrelevant attributes for cleaner interfaces
• Maintain category-specific data requirements

​

Best Practices for Attribute Management

​

Planning Your Attribute Structure

Start with Business Needs:

• Identify what information you need to capture
• Consider how customers will search and filter
• Plan for future growth and new product types
• Align with existing business processes

Design for Scalability:

• Create flexible attribute structures
• Use consistent naming conventions
• Plan for international and multi-language needs
• Consider performance implications of complex structures

​

Naming Conventions

Attribute Labels:

• Use clear, descriptive names
• Be consistent across similar attributes
• Consider user-friendly language
• Avoid technical jargon when possible

Attribute Codes:

• Use consistent formatting (snake_case, camelCase)
• Include prefixes for different types or groups
• Keep codes short but meaningful
• Avoid special characters that might cause issues

Examples:

• Label: “Screen Size”, Code: “screen_size_inches”
• Label: “Waterproof”, Code: “is_waterproof”
• Label: “Primary Color”, Code: “color_primary”

​

Data Quality Guidelines

Validation Strategy:

• Set appropriate validation rules for each attribute
• Balance strictness with usability
• Provide clear error messages
• Test validation rules with real data

Consistency Maintenance:

• Use select lists instead of free text when possible
• Implement data cleaning rules
• Regular audit and cleanup processes
• Train team members on data entry standards

​

Troubleshooting Common Issues

​

”Attribute Not Showing in Product Forms”

Solutions:

• Check if attribute is marked as visible
• Verify attribute group settings
• Ensure proper permissions are set
• Check category-specific attribute visibility

​

”Validation Errors During Data Entry”

Solutions:

• Review validation rules for appropriateness
• Check for conflicting validation settings
• Ensure error messages are clear and helpful
• Test validation rules with various data inputs

​

”Poor Performance with Many Attributes”

Solutions:

• Review which attributes are actually needed
• Optimize validation rules for performance
• Consider grouping strategies to reduce form complexity
• Archive unused attributes

​

”Inconsistent Data Across Products”

Solutions:

• Implement stricter validation rules
• Use select lists instead of free text
• Set up data cleaning rules
• Provide training on data entry standards

​

Advanced Attribute Features

​

Platform Mappings

Multi-Platform Support:

• Map single attributes to multiple platforms
• Handle platform-specific naming requirements
• Manage different data formats per platform
• Maintain consistency across all channels

Configuration Options:

• Enable/disable attributes per platform
• Set platform-specific validation rules
• Configure different display formats
• Handle platform-specific requirements

​

Conditional Logic

Smart Attribute Display:

• Show attributes based on other attribute values
• Hide irrelevant attributes automatically
• Create dynamic forms that adapt to product types
• Improve user experience with contextual fields

Dependency Management:

• Set up attribute dependencies
• Validate related attribute combinations
• Ensure data consistency across related fields
• Provide guidance for complex attribute relationships

​

Bulk Attribute Operations

Mass Updates:

• Update multiple attributes simultaneously
• Apply changes across product selections
• Use filters to target specific products
• Maintain data integrity during bulk operations

Import/Export:

• Export attribute definitions for backup
• Import attributes from other systems
• Migrate attribute structures between projects
• Share attribute configurations across teams

​

Getting Help

​

If You Need Assistance

• Attribute Planning: Consult with product and data teams
• Technical Setup: Work with system administrators
• Data Quality: Coordinate with data management teams
• Integration Issues: Contact support for platform-specific problems

​

Useful Resources

• Attribute Templates: Pre-built attribute sets for common industries
• Best Practice Guides: Industry-specific attribute recommendations
• Integration Documentation: Platform-specific mapping guides
• Training Materials: Team training on attribute management