Allow visitors to enter custom text for products

To configure customisation fields for products, when creating or editing the product:

1. Navigate to the Product options section
2. Select the Customisation fields tab
3. Enter the Customisation field label for the field; this is the instruction text displayed to website visitors
   • The label appears just above the actual text field
4. Select the Field type:
   • 1 line field means the visitor will enter only one line of text
   • Text area means the visitor can enter multiple lines of text
5. Configure the Maximum length, which is the maximum number of characters the visitor can input into the field
   • Leave this blank if there is no maximum
6. Select add another to configure multiple customisation fields for the same product
   • There is no limit on the number of customisation fields that can be configured

You can configure customisation fields for products using the product import/export system using the columns Customisation Field Label, Customisation Field Type, and Customisation Field Max Length.

You can configure multiple customisation fields for a product by separating each with a comma.

• Enter the value 1 Line Field to specify a 1 line field
• Enter the value Text Area to specify a multi-line field

The display of customisation fields on product pages is determined by your website's theme. Customisation fields that you configure for a product are displayed on the product page for your website, and if your website is using a quick view, they are displayed there too.

When a visitor enters values into a customisation field and adds the product to their basket, the customisation field labels and the visitor’s inputted text are displayed on the shopping basket page for the visitor to review before completing checkout.

When a visitor adds a product to the basket with one set of values for customisation fields and then adds the same product to their basket with a different set of values for the customisation fields, each product will appear in the basket separately (i.e. as a separate basket product).

When an order is created containing a product with customisation fields that they have entered text into, the entered text appears in the following places:

• In the customer’s order confirmation email
• In the customer’s account on your website (where order information is displayed)
• When viewing an order from the view-order page
• On the order PDF
• In the orders CSV export (available from the view-orders page) in the column labelled Item Comments
• In the orders CSV feed in the column labelled Item Comments

Customisation field labels and customer-entered values can be configured to appear anywhere else in your ShopWired account, website, or the order XML feed where order information is returned by using the variable order.product.comments.

Customisation field labels and customer-entered values are concatenated into a single text string, even where more than one customisation field has been answered by a customer. Field labels and the customer-entered values are separated with a :, whereas multiple customisation fields are separated with a |. You can use a Twig filter such as |split(':') and |split('|') to split the values - contact theme support if you need to make adjustments.

When viewing an order, use the edit comments option in the products section to edit existing comments or add new ones.

The ability to make customisation fields required is not enabled on ShopWired accounts by default. To activate this feature, contact theme support. When creating or editing customisation fields through the product import system, use the column Customisation Field Required with a value of Yes to indicate a customisation field is required.

Whether or not customisation fields are displayed to visitors on selecting a product option (such as a particular variation combination, product choice, or product extra) is not included in ShopWired themes as standard but can be added to a theme depending on your requirements.

For assistance in linking the display of customisation fields to product option(s), contact theme support.