Line Items

Line items define the order-form fields that customers fill out when configuring your product. These are the dimensions, quantities, and other specifications needed to build and price each item.

Overview

Line items are the rows in an order. Each row represents one configuration of your product.

Example Order Form:

The fields shown (QTY, Width, Height, Notes) are your line item configuration.

Default Line Items

When you create a new product, three fields are included by default:

You can customize these defaults or add additional fields.

Adding Line Item Fields

Step 1: Open Line Items

Navigate to your product and click the Line Items tab.

Step 2: Add Field

Click the "+" icon to add a new field.

Step 3: Configure Field

Data Types

Each line item field has a data type that controls input behavior:

Choosing the Right Type

• Fraction for customer-facing dimensions (easier to read)
• Decimal when precise numeric values are needed
• Number for general numeric input
• List when customers should pick from predefined options
• Description for notes or special instructions

Field Settings

Click the edit button on any field to access its settings:

Basic Settings

Document Visibility

Control where each field appears:

Default Values

Fields can have default values that pre-populate:

Static Default

Enter a fixed value that appears by default:

• Default width: 24
• Default quantity: 1

Attribute Default

Pull the default from an attribute:

• Default thickness from material.thickness
• Default price from material.price

Conditional Default

Set defaults based on other field values using Field Change Rules.

Value Constraints

Number fields can enforce a minimum and/or maximum allowed value. This prevents customers from submitting out-of-spec orders — for example, a width below your machine's minimum or a thickness thicker than your stock.

Enabling Value Constraints

1. On the Line Items tab, edit a number field.
2. Open the Value Constraints section.
3. Toggle Enable Value Constraints.
4. Set a Minimum, a Maximum, or both. Leave either blank to leave that side open-ended.

How customers experience it

When constraints are enabled, the storefront validates the field in real time as the customer types (with a brief debounce) and gives clear feedback:

• The allowed range is shown in the field's placeholder and helper text, e.g. Range: 1/4 - 5/4, Min: 1, or Max: 0.5.
• Fractions and mixed fractions are accepted alongside decimals — 1/4, 3/4, 5/4, 2 1/4, and 0.75 are all valid input, which matches how woodworking measurements are usually written.
• A clear error appears when a value is out of range, replacing the helper text — for example "Value must be at least 1/4" or "Value must be at most 5/4".

Empty values aren't checked against the range (use Required separately if the field must be filled in). Constraints apply only to number fields.

Tip: Set both bounds in the units your formulas expect. Because the storefront accepts 1/4 and 2 1/4, you can express tight tolerances naturally without forcing customers to convert to decimals.

Using Line Items in Formulas

Line item fields can be referenced in Pricing and Parts calculations. Both are built with the step-based Formula Builder (or generated for you by the AI Pricing Assistant) — there is no JavaScript code editor.

Reference Format

Reference a line item field directly by its internal name. In the Formula Builder you pick the field from the field list, and it's inserted as a reference:

width
height
qty
depth

Attribute values use dot notation (for example material.price or material.thickness).

Example: Square-Foot Pricing

To charge per square foot, build the formula in the Formula Builder from a few steps:

1. Add a Square Feet measurement (TimberCloud computes width × height ÷ 144 for you), or multiply the width and height fields yourself.
2. Multiply that result by the material.price attribute field.

You can also describe this in plain English to the AI Pricing Assistant — for example "charge the material price per square foot" — and it builds the same step-based formula for you to review and accept. See Pricing for the full walkthrough.

Example: Part Dimensions

Part dimensions can reference line item fields:

• Stile length: height + lip_factor
• Rail length: width - (stile_width * 2)

Single Line Item Mode

New products are single line item by default. To let a product take more than one line item per order, enable Multi Line Item in product settings:

When Multi Line Item is off:

• Customers can only configure one item per order
• No "Add Row" button appears
• Good for products with fixed configurations

List Fields

Create dropdown selections for line items:

Creating a List Field

1. Add a new line item field
2. Set data type to List
3. Define the options

List Options

Each option has:

• Label: Display text
• Value: Internal value (for formulas)

Example: Room Selection

In formulas, reference as room to get the selected value.

Best Practices

Naming

• Use lowercase, single-word names internally (width, height)
• Use clear labels for customers ("Width (inches)")
• Be consistent across products

Required Fields

• Mark essential fields as required
• Don't over-require—only fields truly needed
• Consider customer workflow

Value Constraints

• Set min/max on dimension fields to keep orders within what you can actually build
• Express limits as fractions when that's how your shop measures (e.g. min 1/4)
• Pair constraints with Required so a critical dimension is both present and in range

Document Settings

• Invoice: Customer-relevant fields only
• Cut Sheet: Production-relevant fields
• Keep documents focused and readable

Mobile Considerations

• Fewer fields = better mobile experience
• Use appropriate keyboard types (number fields show number keyboard)
• Group related fields logically

Common Configurations

Cabinet Door

Drawer Box

Simple Product

Field Change Rules

Field Change Rules allow one line item field to automatically update other fields when its value changes. This enables dynamic form behavior without custom code.

Common Use Cases

Creating Rules

1. Edit a line item field
2. Expand Field Change Rules section
3. Click Add Rule
4. Configure the condition and actions

Condition Operators

When the field value changes, check if it meets a condition:

Action Types

When a condition is met, perform one or more actions:

Example: "Has Rails" Toggle

A common pattern for cabinet doors:

Trigger Field: has_rails (Boolean)

Rule:

• When has_rails equals true:
  • Set top_rail = "2 1/4"
  • Set bottom_rail = "3"
  • Set stile_width = "2 1/4"

This auto-fills rail dimensions when the toggle is enabled.

Example: Material-Based Values

Auto-fill values based on product attribute selection:

Trigger Field: edge_type (List)

Rule:

• When edge_type equals "Applied Edge":
  • Set edge_thickness from attribute Edge.thickness
  • Set edge_material from attribute Edge.name

Display as Fraction

For numeric values being set, enable Display as Fraction to convert decimal values to fractional format:

• 2.25 → 2 1/4
• 0.5 → 1/2

Multiple Actions per Rule

A single rule can trigger multiple actions. All actions execute when the condition is met.

Multiple Rules per Field

Add multiple rules with different conditions. Rules are evaluated in order when the field changes.

Visibility Conditions

Visibility Conditions control when a field is shown or hidden based on other values. Use this to create dynamic forms that adapt to user selections.

Enabling Visibility Conditions

1. Edit a line item field
2. Expand Visibility Condition section
3. Toggle Enable
4. Configure the condition

Condition Sources

Control visibility based on two types of sources:

Line Item Field

Show/hide based on another field in the order form:

Example: Show "Grain Direction" only when "Has Grain" is true

Product Attribute

Show/hide based on a selected product attribute option:

Example: Show "Veneer Edge Width" only when Material.name equals "Walnut"

Example: Material-Specific Fields

Show grain direction only for wood materials:

The "Grain Direction" field will only appear when the customer selects Oak material.

Example: Boolean-Controlled Fields

Show detail fields only when a toggle is enabled:

The "Hinge Spacing" and "Hinge Cup Size" fields only appear when hinge boring is enabled.

Example: Numeric Threshold

Show oversized handling field when dimensions exceed limits:

The "Oversized Handling" dropdown appears only for items wider than 48".

Preview

When configuring a visibility condition, a preview shows the rule in plain language:

"Grain Direction" will be shown when "Material" → "Option Name" equals "Oak"

Troubleshooting

Field Not Appearing

• Verify the field is saved
• Check visibility settings (Visible to Customer)
• Refresh the product page
• Check visibility conditions — the field may be hidden by a condition

Value Out of Range

• Confirm the customer's entry is between the field's Minimum and Maximum
• Remember fractions count toward the same range (e.g. 2 1/4 = 2.25)
• If valid values are being rejected, double-check the min/max you set on the field

Formula Reference Errors

• Field names are case-sensitive
• Check for spaces in field names
• Verify the field exists on the product

Default Value Issues

• Ensure attribute reference is correct
• Check that the attribute option has a value
• Test with a new order

Rules Not Triggering

• Verify the condition matches your test value exactly
• Check that the target field exists
• Ensure the rule is on the correct source field
• For attribute-based rules, verify the attribute name matches

Visibility Condition Not Working

• Ensure the condition is enabled
• Verify the source field/attribute name matches exactly
• For attribute-based conditions, check that the attribute has been selected
• Test with different values to verify the condition logic

Next Steps

• Attributes — Define selectable options
• Pricing — Use line items in pricing formulas
• AI Pricing Assistant — Describe pricing in plain English
• Parts — Reference line items in part specs
• Formula Builder — Step-based calculation builder