SmartCut Docs

Appearance

WordPress Plugin ​

The SmartCut WordPress plugin integrates cutting optimization directly into your WooCommerce store, enabling cut-to-size e-commerce functionality.

Essentials ​

Before getting started, ensure these foundational requirements are met:

  1. Add your domain to your SmartCut account (24-hour activation period, or contact support for expedited activation)
  2. Install WooCommerce plugin on your WordPress site
  3. Use the Storefront theme (the official WooCommerce theme)
  4. Minimize plugin installations - keep additional plugins to a minimum
  5. Avoid page builder tools until compatibility is thoroughly verified
  6. Skip caching plugins that may alter JavaScript loading order
  7. Enable automatic plugin updates to stay current with the latest features

Important

Most issues encountered are related to the points above. Following these guidelines will ensure smooth operation.

Installation ​

  1. Download smartcut.zip from your SmartCut account dashboard
  2. In WordPress admin, navigate to Plugins > Add New > Upload Plugin
  3. Upload the smartcut.zip file
  4. Activate the plugin

Local Server Testing ​

For local development, use localhost as the hostname rather than custom domains or IP addresses to enable proper domain validation.

Product Category Setup ​

Create a dedicated product category to identify cut-to-size items:

  1. Create a new product category in WooCommerce
  2. Navigate to SmartCut > General settings
  3. Configure the category for cut-to-size products
  4. Apply this category to all relevant products

TIP

Complete this step before other configuration tasks to streamline your setup.

Product Templates ​

The SmartCut admin menu offers template generation featuring example products:

  1. Navigate to SmartCut > Templates
  2. Select a template that matches your business structure
  3. Customize the template to your needs
  4. Ensure the category slug aligns with your saved settings

Global and Product Settings ​

Settings operate in a hierarchy: Product settings override Global settings.

Implement global settings strategically to reduce administrative overhead when updates are needed across your store.

Pricing Strategies ​

SmartCut supports multiple pricing approaches:

  • Full sheet pricing - Price based on complete sheets
  • Part area-based pricing - Calculate price by part area
  • Cut length pricing - Price based on linear cutting
  • Full sheet plus cut length - Combined pricing model
  • Full sheet plus number of parts - Price by sheet and part count
  • Additional surcharge options - Custom pricing adjustments

Product Structure ​

Attribute Configuration ​

WooCommerce product attributes manage variable options. Follow these guidelines:

Simple Products with Fixed Stock ​

  • Use length and width attributes (millimeters or inches)
  • Optional thickness attribute (required for beam saws)

Variable Products with Multiple Thicknesses ​

  • Use thickness attribute separated by pipes: 8 | 12 | 16
  • Omit units

Variable Products with Multiple Sizes ​

  • Use size format: 2440×1220
  • Multiple options: 2440×1220 | 1000×1000
  • Do not combine with length/width attributes

Variable Products with Full-Size Purchase Option ​

  • Add "Cut-to-size" as a text option
  • Example: 2440×1220 | 1000×1000 | Cut-to-size

Critical

Do not add units to dimensions or sizes. The plugin will handle unit conversion based on your store settings.

Edge Banding and Finishes ​

These "extras" are managed via standard WooCommerce products linked to cut-to-size offerings. They can be hidden from customers by setting them as Private.

Naming Constraints ​

WARNING

Extras names must only contain numbers, letters, underscores, hyphens & brackets. No other special characters are allowed.

Pricing Specifications ​

  • Banding: Priced by meter or foot
  • Finishes: Priced by square meter or square foot

Simple Extra Products ​

Use simple products when presenting a single list of choices. Each option requires its own product with controlled pricing. Product slugs identify extras in orders, PDFs, and CSV files.

Variable Extra Products ​

Introduced in version 3.1, variable extras allow breaking up choices (e.g., separate color and thickness selection):

  1. Add attributes to the extra product
  2. Generate variations
  3. Set prices accordingly

Restriction

When using variable extra products, add only one product slug at a time to avoid errors.

CSV Import for Parts ​

When Settings > Cut list configuration > Enable CSV import is enabled, users can import parts via CSV.

  1. Download the example template from the support documentation
  2. Ensure the template is available on your site

Critical Requirement

Units used in the import must match your store-wide units set in Settings > Cut list configuration

CSV columns include:

  • Length
  • Width
  • Quantity
  • Rotation
  • Name

All columns are optional and can be removed as needed.

Translation ​

Translation occurs in two stages:

1. Cut List Widget ​

Manual translation via provided Google Doc

2. Store Text ​

Use WooCommerce-compatible translation plugins:

  • Loco Translate (officially supported)
  • Other compatible WooCommerce translation plugins

Troubleshooting ​

Cut List Interface Not Displaying ​

Verify the following checklist:

  • ✅ SmartCut plugin installed and activated
  • ✅ Domain added to SmartCut account with proper www designation
  • ✅ Cut-to-size category created and applied to products
  • ✅ Product pricing configured (simple products or variations)
  • ✅ Product stock status set appropriately
  • ✅ Storefront theme in use
  • ✅ Minimal plugin interference
  • ✅ Caching properly configured
  • ✅ Browser cache cleared

Server Connection Issues ​

For local servers: Use localhost as the hostname.

For live URLs:

  • Confirm domain registration in your SmartCut account
  • Allow 24 hours for activation
  • Contact support for expedited processing if needed

Common error message: "We are having trouble connecting to the server"

This typically indicates:

  • Localhost configuration issues, or
  • Incomplete domain setup

Version Downgrade ​

If you need to revert to a previous version:

  1. Access your SmartCut account dashboard
  2. Navigate to the plugin downloads section
  3. Select and download the desired version of smartcut.zip
  4. Upload via WordPress Plugins menu

Support ​

The platform is designed for self-service setup using provided templates as references.

For assistance:

Current Plugin Version: 4.3.9 Platform: Built for WooCommerce