Product Attributes
Product attributes can be used to specify different versions of a product by either specifying predefined versions (through selection lists) or by allowing the customer to enter or submit data.
The following product attribute types are currently available:
| Attribute Type | Description |
|---|---|
| Drop-Down Lists | Allows the selection of one option from a predefined dropdown list. |
| Radio Buttons | Allows the selection of one option from a predefined radio button list. |
| Text Input | Allows the customer to add a text to an ordered product through a text input at the storefront |
| Checkbox | Allows the optional selection of a single option. |
| Textarea Input | Allows the customer to add a large text to an ordered product through a textarea at the storefront |
| File Input | Allows the customer to add a file to an ordered product though a file input selection at the storefront. |
| Date/Time Input | Allows the customer to add a date and time to an ordered product at the storefront. |
| Date Input | Allows the customer to add a date to an ordered product at the storefront. |
| Time Input | Allows the customer to add a time to an ordered product at the storefront. |
a) Add new Attributes
After a product was saved, you can add attributes to this product.
The add a new attribute form:
The add a new attribute form is used to set the general settings for a new product attribute.
The following fields are available for new product attributes:
| Field | Description |
|---|---|
| Attribute Name | The internal name for the product attribute. |
| Attribute Caption | The caption for the attribute. This caption is visible at the storefront for that product attribute. |
| Priority | Sorting priority for the product attribute. |
| Attribute Type | The type of the attribute. The following attribute types are available:
|
| Options (for option lists) | Options for dropdown lists, radio buttons and checkboxes |
| Text Length (for Text Input) | Maximum text length, if text input is chosen as attribute type |
| Is Active | Specify, if the attributes is currently active or not. |
| Is Active Track Inventory | Specify, if the inventory is tracked through this attributes or not. |
Drop-down select boxes and radio buttons and with some limitations, checkboxes too, have an option list where several parameters can be added to change the weight or price of the product. You can add several options by adding them, one value per line, at the options list. Each line in the option list is selectable by itself at the storefront and functions as a sub-option.
Please note: The first option in a radio button list and drop-down list is always preselected at the storefront. If you want to make this attribute type optional, you can set the first item to be blank or to not have an actual option.
e.g.: if you have a dropdown list or radio button list with the name “Extras” and the following options in the options list:
- none
- red
- blue
- green
- red
- blue
- green
Please note: Drop-down and radio button lists are optional or mandatory depending on the first item in the options list.
Since checkboxes are single (and only single) options themselves, only one option can and should be added to the option list, if checkbox is selected as type. For several options you need to create several checkboxes.
Please note: Checkboxes are always optional.
Drop-down select boxes, radio buttons and checkboxes can have additional optional parameters for their options.
The parameters are entered in the following format: (parameter1,parameter2).
The first parameter is the price modifier, the second parameter is the weight modifier. You can use a percentage amount or decrease/increase the original product values for price and weight either with fixed or with percent values.
Modifiers are separated by comma ”,” and the whole parameter section is in brackets ”()”.
| Example | Description |
|---|---|
| supersafer(-20,-0.30) | Price is decrease by 20, weight is decreased by 0.30 weight units |
| medium(-5%,+2) | Price is decreased by 5%, weight is increased by 2 weight units |
| deluxe(0,+3) | Price remains the same, weight is increased by 3 weight units |
| special(+40.00) | Price is increased by 40 |
Weight and Price modifiers are in the default store weight and price units.
If you select text input as attribute type, you can limit the text length of the attribute.
Text inputs can be used for optional attributes where a text input from a customer is needed, e.g.: if the customer can choose an optional text for engraving a ring
Textarea inputs don’t have any additional parameters and are used where large text inputs are needed from a customer, e.g. the text for a wedding invitation card.
File input, date/time, date and time inputs also don’t have any additional parameters.
After you set all your settings, click on the „Apply Changes“ button to add this attribute to the product. After adding the attribute to the product, it can be edited through the product attributes list (see below).
b) Global Attributes
Global attributes allow you to easily add predefined attributes to a product. To learn more about how to create global attribute go to the global attributes page.
The assign global attributes form:
The assign global attributes form is used to assign global attributes to a product. The list at this section shows all current active global product attributes that can be applied to the current product. The information shown includes the title the caption and - if available - the options for this attribute.
Select the global attributes you want to assign to the product and click on the “Apply Changes” button to assign the selected global attributes to the product.
Once assigned global attributes are added as normal attributes to the product and can be edited or changed through the product attributes list (see below).
c) Custom Attributes
Custom attributes are special product attributes for special purposes.
The custom attributes section:
The custom attributes section allows you to create dynamic and advanced attributes. Clicking on the links will either open the dynamic attributes details page for this product or the advanced attribute builder.
This section also shows how many dynamic and advanced attributes are currently assigned to the current product.
Please note: Custom product attributes are deprecated and shouldn’t be used anymore! They are included solely for backwards compatibility.
d) Product Attributes List
The product attributes list shows all attributes, that are currently assigned to the current product.
The product attributes list:
The product attributes list shows all assigned attributes if the current product. The list shows information like the internal attribute ID, the attribute name and caption, the sorting priority of the attribute, if the attribute is active and if it is used to track inventory or not.
Depending on the attribute type (dropdown lists, radio buttons and checkboxes have options), the list shows also information about the product attribute’s options including their price and weight modifiers and if any images or files are assigned to these options.
To add or modify the options, except for the visible fields in the list, click on the “Advanced Edit” button to open the advanced edit page for this attribute.
The advanced edit page allows you to add or change an attached file that the customer receives, when buying the product with this option selected, or to change the assigned image of an option, to add more options, remove options, etc..
Click on the “Delete” button on the right side of each attribute in the list to completely remove this attribute.
The attributes list also allows you to bulk change all the assigned attribute by changing the field values and clicking on the “Save Changes” button to save the changes
e) Product Attribute Details
The product attribute details page allows you to edit all details of a product attribute and it’s options
The product attribute details form:
The product attribute details form shows all the details of a selected attribute including it’s options. The form shows information like the internal attribute ID, the attribute name and caption, the sorting priority of the attribute, if the attribute is active and if it is used to track inventory or not.
The form also shows information about the product attribute’s options including their price and weight modifiers and if any images or files are assigned to this option. It also allows you to either change the assigned images and files or remove them.
You can add a new option by entering data into the last empty option in the option list of the attribute. Click on the „Save Changes“ button to save an added option and to add another one, if desired.
Option images are shown instead of the normal product image, if an option with an image is selected (provided the selected image preview functionality for the product supports image swapping).
Please note: Attached option files are only available for the customer, if the customer chooses this option
Click on the “Save Changes” button to save any changes to this attribute.
Click on the “Edit Product Information” button to return to the product details page.