Overview
A product model in Gelato defines how a product is structured. It consists of:
Parts: A product model can have multiple parts or no parts. Each part is itself a product model. For example, a photo book could have a cover (part 1) and an inner (part 2).
Attributes: These describe the product’s characteristics, such as size, substrate, or color.
Derived Attributes: Attributes calculated using formulas based on other attributes.
Examples of Product Models
Photo Book
Part 1: Cover (based on the flat product model)
Attributes: 9 attributes
Part 2: Inner (based on the flat product model)
Attributes: 9 attributes
Poster
Parts: No parts
Attributes: 9 attributes (based on the flat product model)
Mug
Parts: No parts
Attributes: 3 attributes (based on Gelato's mug product model)
Steps to Create a Product Model
1. Adding a Product Model
Navigate to the product model section.
Add a new category or choose from an existing one. For instance, if you want to categorize a poster under "Wall Art," you can either type in the name of a new category or select one from the list.
Name your product model.
Add a description for the product model.
2. Adding Parts to a Product Model
Parts are necessary if the product has components that require different workflows. A product model doesn’t need parts but can have as many as required.
Each part is a product model itself.
When adding a part, you can choose from existing product models in your account.
Best Practice: First, create the product models that will be used as parts, then link them when creating the overall product model.
3. Adding Attributes to Your Product Model
A product model without parts needs at least one attribute. If the product has parts, adding attributes is optional.
You can use Gelato’s pre-configured attributes (with their values) or create custom attributes.
Select attributes that best describe your product.
Tip: Click here to see the attributes used in popular Gelato product models.
4. Adding New Values to an Attribute
Click on the attribute you want to edit.
Click "Add New Value."
Enter the required information and click Save.
Recommendation: Follow the naming conventions used in the system (e.g., Size1Mm and Size2Mm for sizes). Although not required, it helps to maintain consistency across different parts of the Gelato system.
For example, if you're adding a size in inches, convert the values to millimeters.
Example: For a 9x23 inch product:Size1Mm = 228.6 (9 inches)
Size2Mm = 584.2 (23 inches)
5. Using Derived Attributes
Derived attributes are calculated based on formulas and provide key product characteristics. A minimum set of mandatory derived attributes is required for every product model.
Note: Currently, you cannot add new derived attributes, but this feature is coming soon.
Formulas are written in JavaScript and must return a specific value.
Example: To calculate the weight of a poster:
attributes.PaperType.WeightGsm * attributes.PaperFormat.Size1Mm * attributes.PaperFormat.Size2Mm / 1,000,000
This formula calculates the area of the product (Size1Mm * Size2Mm), multiplies it by the weight (WeightGsm), and divides by 1 million to get the weight in grams.
Tip: Use the formula generator for assistance. Simply describe the formula in plain text (e.g., "size1 * size2 * weightgsm / 1000000"), and it will generate the code for you.
Common Derived Attributes
Derived attribute | Description |
Width | The width of the product |
Height | The height of the product |
Length | The length of the product |
Thickness | The thickness of the product (same as length) |
Unit System | The unit system used - metric or imperial |
Weight | The weight of the product in grams |
Packaging Width | The width of the product in a package (currently not used in other systems) |
Packaging Height | The height of the product in a package (currently not used in other systems) |
Packaging Length | The length of the product in a package (currently not used in other systems) |
6. Saving the Product Model
Once you have configured all attributes and derived attributes, save the product model.
Need Assistance?
If you have any questions or need further guidance, feel free to contact our support team or the product manager directly on [email protected]