Attributes

Attributes define the selectable options for your products—materials, finishes, edge profiles, hardware, and any other choices customers make when ordering.

Overview

Attributes are organized into tables with customizable columns. Each row represents an option the customer can select.

Example: Material Attribute

When a customer selects "Cherry," your pricing and parts formulas can reference material.price (25), material.thickness (0.75), or material.weight (0.8).

Creating an Attribute

Step 1: Open Product Attributes

Navigate to your product and click the Attributes tab.

Step 2: Add Attribute

Click the "+" icon to create a new attribute.

Step 3: Define Structure

Note: The "Name" column is automatically included—you don't need to add it.

Step 4: Choose Data Types

For each column, select the appropriate data type (see Data Types below).

Step 5: Add Rows

After saving the structure, add rows to your attribute table. Each row represents one selectable option.

Data Types

Each column in your attribute table needs a data type:

Choosing the Right Type

• Price for costs and upcharges
• Fraction for dimensions that customers see (3/4", 1 1/2")
• Decimal for calculations (thickness in formulas)
• Description for text information
• Boolean for yes/no features

Using Attributes in Formulas

Attributes are referenced in Pricing, Parts, and Inventory formulas.

Reference Format

attribute_name.column_name

Examples

In the Formula Builder

1. Click "Add Step"
2. Select "Field" as the operand type
3. Choose the attribute from the dropdown
4. Select the column/property

In the Code Editor

// Price based on material and edge options
const sqFt = (width * height) / 144;
return sqFt * material.price + edge.upcharge;

CSV Import/Export

Speed up attribute setup with CSV files.

Exporting Attributes

1. Open the attribute you want to export
2. Click the "Export CSV" button
3. Save the file for backup or editing

Importing Attributes

1. Prepare a CSV with headers matching your attribute structure
2. Click "Import CSV"
3. Select your file
4. Review and confirm the import

CSV Format

Your CSV should have:

• First row: Column headers (must match attribute columns)
• Subsequent rows: Option values

Example:

Name,Price,Thickness,Weight
Cherry,25,0.75,0.8
Maple,30,0.75,0.5
Walnut,35,1.25,1.2

Common Attributes

Here are common attributes for woodworking products:

Materials

Edge Profiles

Designs/Styles

Finishes

Attribute Layout

Control how attributes appear in the order form:

Display Order

Drag and drop attributes to reorder them in the customer-facing form.

Grouping

Group related attributes together for a cleaner interface.

Required vs. Optional

Mark attributes as required to ensure customers make a selection.

Best Practices

Naming

• Use clear, customer-friendly names
• Be consistent across products
• Avoid abbreviations in customer-facing names

Structure

• Keep attribute tables focused (one concept per attribute)
• Use appropriate data types for calculations
• Include all values needed for formulas

Maintenance

• Review and update prices regularly
• Archive discontinued options rather than deleting
• Use CSV export for backups

Troubleshooting

Attribute Not Appearing in Formulas

• Verify the attribute is saved
• Check that column names are lowercase in formula references
• Refresh the formula builder

Import Errors

• Ensure CSV headers match exactly
• Check for special characters in values
• Verify data types match (numbers vs. text)

Calculation Issues

• Confirm the correct column is referenced
• Check for null/empty values in attribute rows
• Test with known values

Next Steps

• Line Items - Configure order form fields
• Pricing - Use attributes in pricing formulas
• Parts - Reference attributes in part dimensions
• Formula Builder - Visual calculation builder