Creating and Configuring Custom Fields for Products

A custom field is an extra piece of data or an option you wish to be saved against the order of a product or group of products. For example, you may have additional options for a product, such as special variants, or perhaps a special offer to include extra items with a product if the customer chooses to pay a little more. The custom fields can also be used just to collect survey data from customers - the possibilities are quite endless. Custom fields can also be used to modify the price of a product for increased flexibility in your product range.

Prerequisites

You must have administrator access to use this feature

There are 2 parts to configuring a custom field. The first is creating the custom field, which this article covers. The second part is to assign that custom field to products that will use it. This is partly carried out here and partly carried out at the product or product group level (see articles about Product Groups and Using Custom Fields in Products).

To Manage Custom Fields:

Log into your DecoNetwork Website.
Browse to Admin > Products.
Select Custom Fields.
- The Custom Fields main work area will show you a list of previously configured custom fields. You may choose to Edit or Delete these (options described below). You can sort the order of the custom fields by using the ^ and ^ icons.
- Alternatively, you may create a new custom field by clicking the Add Custom Field button.
Configure a custom field's settings as required.
Custom Field Settings

When you add or edit a custom field, the settings for the custom field will be displayed.

Each setting is described below.

Field on by default

Ticking this checkbox will display this custom field as an option when the default behavior for the product is also to display custom fields. This corresponds to a product's custom field configuration to "Use System Fields" (found under Admin > Products > [product] > Custom Fields). Additionally, if the Product Groups app is enabled, the behavior of the product group is set at Admin > Products > Product Groups.

Required

Ticking this checkbox will force the user to complete the custom field as the product enters the shopping cart.

Title

This is the name of the field.

Description

Description lets you provide information that can be in the form of a question or a prompt that will help the customer to complete the custom field.

Type

Type defines which sort of on-screen input method the customer will use to enter data.
- Text field types provide an open text box that accepts free text input.
  - Text Field accepts single-line text input.
  - Text Area accepts text input of multiple lines.
  The following settings are available for text field types:
  - Length (Text Field only) lets you specify the width of the text box based on the number of characters. For instance, setting the size to 30 will make the text box wide enough to display 30 characters, but you can still enter more than 30 characters if needed.
  - Rows (Text Area only) lets you specify the number of text lines for the text box.
  - Columns (Text Area only) lets you specify the width of the text box based on the number of columns to display.
  - Maximum Characters lets you specify the maximum number of characters that can be entered in the text box.
- Select field types provide the customer with a number of options.
  - Drop-down is a list that opens up when the user clicks on the field.
  - Checkbox gives the customer a choice of checkable options, and multiple selections may be made.
  - Radio buttons allows the customer to choose only one of a predefined set of options.
  - Multiselect is like a dropdown, except multiple options can be selected.
  The list of options is set by you, and must be configured prior to use. Click on the Add Option button to add options.
  
  Added options appear in a table below the Type selection box:
  - On means the option will be used.
  - Default is the option selected on page load.
  - Name is the text that will appear in the option.
  - Code is the text saved from selecting the option.
  The blue configuration wheel at the right of the Options table contains extra options for the Select field type to set price modifiers and also size variants:
  - [Title] affects price makes the price modifier options available.
    - Price depends on color lets price be modified based on the color of the product being sold. Options here are to modify by a flat fee or as a percentage of either the base price, the decoration price, or both.
    - Allow size variants will let you add size variants to each option.
- File field types let the customer upload an attachment to their order.
  - File lets the customer upload file attachments to their order
  - Image lets the customer upload image attachments to their order.
  The following settings are available for file field types:
  - Allowed file extensions lets you specify the extension of the file types you want to allow. Leave this field blank if you want to accept all file types.
- Date field types open up picker selection dialogs with the selection used as the output. These types cannot modify the price of a product.
  - Date lets the customer select a date.
  - Date/Time lets the customer select both date and time.
  - Time lets the customer select a time.
Price Options

The blue configuration wheel at the right of the Price Options title contains extra options for the selected field type to set price modifiers:
- [Title] affects price makes the price modifier settings and options available.
  - Price depends on color lets price be modified based on the color of the product being sold. Options here are to modify by a flat fee or as a percentage of either the base price, the decoration price, or both.
When the [Title] affects price checkbox is ticked, the Adds field becomes available. Specify a flat price or percentage of the base or decoration price depending on the setting in the settings box.

When the Price depends on color checkbox is also ticked, the White, Light and Dark fields become available. Specify a flat price or percentage of the base or decoration price for each of the color variants, depending on the setting in the settings box.
Once your configuration is complete, click Save.