Part Models¶

Part Models represent product model variations organized hierarchically by brand. This feature allows you to create a structured taxonomy of product models with parent-child relationships, making it easier to manage complex product lines and variants.

Overview¶

Part Models are useful for:

Organizing product variants by model type and brand
Creating hierarchical structures (parent models with multiple sub-models)
Managing brand-specific models from multiple manufacturers
Structuring catalog for easy product navigation
Supporting product configurations that link to specific models
Multi-language support for international markets

Accessing Part Models¶

Navigate to Catalog Management > Part Models from the admin sidebar.

Part Models List

Understanding Part Models¶

Model Components¶

Each Part Model includes:

Brand: The manufacturer or brand this model belongs to
Parent Model: Optional reference to a parent model (for creating hierarchies)
Name: The model designation (translatable across languages)
Image: Optional image representing the model

Hierarchical Structure Overview¶

Part Models support multi-level hierarchies. The typical structure is:

Brand (e.g., Apple)
├── Product Line (Parent Model - e.g., iPhone 15)
│   ├── Variant (Child Model - e.g., iPhone 15 Pro)
│   ├── Variant (Child Model - e.g., iPhone 15 Pro Max)
│   └── Variant (Child Model - e.g., iPhone 15 Plus)
└── Product Line (Parent Model - e.g., iPhone 14)
    ├── Variant (Child Model - e.g., iPhone 14 Pro)
    └── Variant (Child Model - e.g., iPhone 14 Plus)

Key Points: - Each model can have ONE parent (not multiple) - Parent models don't need to be directly under a brand (can be nested deeper) - Leaf models (without children) are the final variants customers select - The hierarchy is maintained automatically by the system

List View¶

Part Models List

Table Columns¶

Brand¶

Shows: Manufacturer name
Purpose: Groups models by company
Sortable: Yes

Parent Model¶

Shows: Parent model name (if this is a child model)
Purpose: Identifies the model's parent in hierarchy
Empty: If this is a top-level model

Name¶

Shows: Model designation
Purpose: Display name shown to customers
Searchable: Yes
Translatable: Yes

Image¶

Shows: Thumbnail preview of model image
Purpose: Visual representation
Optional: Yes

Created At / Updated At¶

Shows: Timestamps
Visibility: Hidden by default

Searching and Sorting¶

Search by name: Find models by typing the model name
Sort by brand: Organize all models by manufacturer
Sort by parent: Group child models together
Filter by brand: Use filter to show models from specific brand

Managing Part Models¶

Creating Part Models¶

Create Part Model

Top-Level Model (No Parent)¶

Click New Part Model
Select a Brand from the dropdown (required)
Leave Parent Model empty (optional)
Enter the Name (required, max 200 characters)
Examples: "iPhone 15", "Galaxy S24", "MacBook Pro"
Upload an Image (optional)
Recommended size: 300×300px or larger
Formats: JPG, PNG
Click Create or Create & create another

Child Model (With Parent)¶

Click New Part Model
Select the same Brand as parent
Select Parent Model from dropdown
This links it to an existing top-level or intermediate model
Enter the Name for the variant
Examples: "iPhone 15 Pro", "Galaxy S24 Ultra"
Upload an Image (optional)
Click Create

Important: Child models must belong to the same brand as their parent.

Editing Part Models¶

Click Edit in the Actions column
Modify any fields:
Model name (in selected language)
Brand (if needed)
Parent model (reorganize hierarchy)
Image (update or replace)
Click Save to apply changes

Note: Changes affect all products using this model.

Deleting Part Models¶

Click Delete button
Confirm deletion

Warning: Deleting a model affects products linked to it. Consider whether products should retain this association.

Hierarchical Organization¶

How Hierarchy Works¶

The parent-child relationship creates a logical structure:

Create parent model first (e.g., "iPhone 15")
This is a top-level model with no parent
Represents the product line
Create child models under the parent (e.g., "iPhone 15 Pro")
Select the parent model during creation
Can create multiple children under one parent
Each child must have the same brand as its parent
System maintains relationships automatically
Changing parent model reorganizes the hierarchy
Deleting parent doesn't delete children (they become top-level)

Practical Hierarchy Example¶

Apple Brand:

iPhone 15 (Parent)
├── iPhone 15 Pro (Child)
├── iPhone 15 Pro Max (Child)
├── iPhone 15 (Child - standard version)
└── iPhone 15 Plus (Child)

iPhone 14 (Parent)
├── iPhone 14 Pro (Child)
├── iPhone 14 Pro Max (Child)
└── iPhone 14 Plus (Child)

MacBook Pro (Parent)
├── 14-inch (Child)
│   ├── M3 (Grandchild)
│   ├── M3 Pro (Grandchild)
│   └── M3 Max (Grandchild)
└── 16-inch (Child)
    ├── M3 Pro (Grandchild)
    └── M3 Max (Grandchild)

Benefits of Hierarchies¶

Better organization for complex product lines with multiple variants
Easier management of large model collections
Improved product navigation for customers selecting models
Cleaner admin interface by grouping related models
Logical structure that mirrors real product lines

Multi-Language Support¶

Part Models fully support multiple languages:

How Translation Works¶

Create model in default language (e.g., English)
Fill in name, brand, parent, image
These apply to all languages
Add translations by switching locale
Use the Locale dropdown at the top of the form
Enter model name in the selected language
Image is shared across all languages
Brand and parent model relationships are same across languages
Customer experience
Customers see model names in their selected language
Same model appears in all languages with translated names

Translation Example¶

English Model: "iPhone 15 Pro" Arabic Model: "آيفون 15 برو" Spanish Model: "iPhone 15 Pro"

All three show the same product hierarchy and image, but display different names based on customer language selection.

Setting Up Translations¶

Create the model hierarchy in your default language (e.g., English)
For each model, click Edit
Select alternate language from Locale dropdown
Enter translated name
Save
Repeat for all languages you support

Model Relationships¶

Brand Association¶

Each model must belong to exactly one brand
Models from different brands have separate hierarchies
Changing a model's brand doesn't affect products already linked to it

Parent-Child Relationships¶

Each model can have ONE parent (not multiple parents)
A model can have MANY children
Changing a parent reorganizes the hierarchy
No circular relationships allowed (model can't be its own parent, directly or indirectly)

Product Linking¶

Models link to products (described in Products section)
Products use the final model in the hierarchy (usually leaf models)
Deleting a model may orphan products using it

Workflows¶

Workflow 1: Create New Brand with Model Line¶

Navigate to Part Models
Click New Part Model
Select Brand: "Samsung" (or new brand)
Leave Parent Model empty
Name: "Galaxy S25"
Upload image
Click Create

Workflow 2: Add Variants to Existing Model¶

Find "Galaxy S25" in the list
Click New Part Model
Select Brand: "Samsung"
Select Parent Model: "Galaxy S25"
Name: "Galaxy S25 Ultra"
Upload variant image
Click Create
Repeat for: "Galaxy S25", "Galaxy S25+"

Workflow 3: Create Three-Level Hierarchy¶

Create top-level: "MacBook Pro" (no parent)
Create second-level: "14-inch" (parent: MacBook Pro)
Create third-level: "M3 Max" (parent: 14-inch)

This creates: MacBook Pro > 14-inch > M3 Max

Advanced Usage¶

Reorganizing Hierarchies¶

To move a model to a different parent: 1. Click Edit on the model 2. Change the Parent Model field 3. Click Save

The model and all its children are automatically reorganized.

Creating Flat Model Lists¶

If you don't need hierarchy: - Leave Parent Model empty for all models - All models appear at same level - Still grouped by brand

Complex Multi-Level Structures¶

The system supports deep hierarchies: - Level 1: Brand > Model Line (Parent) - Level 2: Variant (Child) - Level 3: Configuration (Grandchild) - Level 4+: Can continue nesting

Use case: Electronics with specs (Brand > Product > Screen Size > RAM > Storage)

Integration with Products¶

Models link to products to specify which model variant a product represents. See Section 5: Products for how to assign part models to individual products.

Quick Reference¶

Field Reference¶

Field	Type	Required	Notes
Brand	Select	Yes	Manufacturer (must exist)
Parent Model	Select	No	For hierarchies
Name	Text	Yes	Model name (max 200 chars, translatable)
Image	Image	No	Model visual (JPG/PNG)

Common Actions¶

Action	Steps	Notes
Create parent model	New Part Model > Brand > Leave Parent empty > Name	Top-level model
Create child model	New Part Model > Brand > Select Parent > Name	Creates hierarchy
Edit model	Edit button > Change fields > Save	Updates all references
Move model	Edit > Change Parent Model > Save	Reorganizes hierarchy
Delete model	Delete button > Confirm	May affect products
Translate model	Edit > Select Locale > Enter name > Save	Repeat for each language

Hierarchy Rules¶

One parent maximum: Each model has 0 or 1 parent
Many children allowed: One parent can have unlimited children
Deep nesting allowed: No limit on hierarchy depth
Same brand required: Children must match parent's brand
Circular references blocked: Can't create circular hierarchies

Brands - Associated with part models
Products - Use part models for product variations
Categories - Organize products by category