This page covers the following topics:

Attribute Value Field Types

X-Cart supports three field types for attribute values:

When configuring an attribute, select the field type that best suits your needs. Below we provide detailed explanation of each type.

Plain field

Choose this field type if you need the attribute value to be a word/phrase of your choice.

You can use Plain field to specify such properties of a product as color, size, ISBN (for books), etc.: it is good foor almost anything, provided you can describe it in a couple of words. For example, we used it to specify the dimensions of a bag:

On the storefront, it shows as follows:

Plain field type can be used to specify multiple values for one attribute.

For details, see Multi-value attributes (product options).


This field type allows for a longer text length than Plain field and can be used to provide lengthier descriptions.

For example, we used it to add detailed information about the fabric and cut of a women’s top:

On the storefront, it shows as follows:

Starting with X-Cart 5.1, the Textarea attribute value field type can be used to add personalization options for products (i.e. provide an editable text area on the product page on the storefront so buyers can use it to enter their own custom text).

For details, see Personalization options.


This field type is intended for attribute values that emphasize the presence or absence of some property or feature. For example, we used it to emphasize the wirelessness of the headphones:

On the storefront, it looks like this:

The Yes/No field type can also be used to specify “Yes or No” options for products.

For details, see Multi-value attributes (product options).

Hidden field

This field type allows to add a hidden global attribute to a product that can be seen and used by a store administrator only (e.g. to add some product info that should not be displayed to customers in the storefront but can be used for admin purposes like Google Product Feed module configuration).

Hidden field attribute is displayed as a separate tab of the Attributes section on the product details page (Attributes -> Hidden attributes):


The Hidden field attribute is configured the same way as the Plain field attribute, however unlike Plain field it doesn’t allow to add multiple values to a product. A store admin can set only one value per a hidden field attribute for a product from the list of available.


Hidden field attibutes unlike global attributes of any other type can be created in the Classes & Attributes section only. See Managing global attributes for more info.

A store admin can use the Bulk Editing tool to configure hidden attributes for multiple products at once.

Multi-Value Attributes (Product Options)

The Plain text and Yes/No attribute value field types allow you to use the multi-value feature, i.e. to specify multiple values for one attribute. In X-Cart 5 this feature is used to specify the product options that customers will be able to choose. For example, you can use Plain field attribute values to provide information about the available sizes of a garment. Specific sizes like XS, S, M and L can be made into product options if you add them as values for the attribute “Size” like so:

On the storefront, it shows as follows:

Note how the attribute values XS, S, M and L have become product options that buyers can choose from a drop-down list before adding the product to their cart.

To achieve this setup:

  1. Use the Attribute option field next to the attribute name to enter the attribute value that should go first in your list of values for the attribute (In our example, we simply typed in “XS”).
  2. Hover your cursor over the blank area to the right of the Attribute option field. This reveals a check box that says multi value:
  3. Select this check box to enable multiple values for the attribute you are editing. A new empty line is added to the attribute values list:
  4. Use the Attribute option field on the new line to type in the next attribute value name. As soon as you start typing, another empty line will be added to the list:
  5. Continue until you have added all the attribute values you require.
  6. Choose whether you want to apply the changes locally or globally.
  7. Click Save changes.

With the Yes/No field type, it is quite similar; the only difference is that there are just two options, Yes and No, and you do not have to type them manually, but can select them from a list.

On the storefront, customers can choose the option they require by adjusting the respective check box:

It should be noted that the method for specifying product options described above does not provide a way to track how many product units with a specific option you have sold and how many you still have on hand. Also, if the product has more than one multi-valued attribute, there is no way to specify, which option combinations (product variants) are actually available. If you need these features, consider installing X-Cart’s Product Variants module. This module allows you to create product variants from options and make them have their own prices, SKUs and stock levels.

Personilization Options (Editable Textarea)

Starting with X-Cart 5.1, it is possible to add editable Textarea attribute values. Adding an editable attribute value  for some product attribute creates an empty editable text area field on the product page where buyers can enter their own custom text before adding the product to their shopping cart. This feature may be used if you are going to provide personalization options for products, like monogramming, embroidery, etc.

To add a Textarea attribute value as editable, you need to leave the Attribute option field empty and select the editable check box next to it before saving the changes (The check box is hidden and is revealed only when you hover your cursor over the blank area to the right of the Attribute option field).

The snapshot below provides an example of how an editable text area attribute value can be used to allow customers to enter custom monogram text for a bath towel:

On the storefront, it looks like this:

Price and Weight Modifiers

Attribute values for multi-value product attributes can be configured as price and/or weight modifier options that will increase or decrease the price and/or weight of the product (the product’s weight affects the shipping cost). 

Here’s an example of a price modifier option that allows customers purchasing a towel to add a monogram for an additional $10 per unit:

Here’s what it looks like on the storefront:

Notice how the price of the product changes when the check box “Monogram this item? (+ $10.00)” is selected:

To configure attribute values as price/weight modifiers:

  1. Hover your cursor over the field displaying the attribute value that you want to make a price modifier. For example, we want the option “Monogram this item?…..Yes” to have the price of $10, so we hover over the attriibute value “Yes”. A link titled Modifiers is revealed:
  2. Click on the Modifiers link. This displays a popup panel allowing you to specify the price and/or weight by which this option will alter the product’s price and/or weight:
  3. Use the Price and/or Weight field(s) on the popup panel to specify the modifier values you require. These can be In our case, we need to specify the price modifier:
  4. Choose whether you want to apply the changes locally or globally.
  5. Click Save changes: The settings will be saved.

Setting the Default Attribute Value

When configuring multi-value attributes, you can control which of the attribute values should be shown to customers by default.

To set the default attribute value:

  1. Hover your cursor over the field displaying the attribute value that you want to make the default one. For example, we want the option “Monogram this item?…..No” to be available to users by default, so we hover over the attriibute value “No”. A link titled Modifiers is revealed:
  2. Click on the Modifiers link. This displays a popup panel:
  3. Select the Default option check box:
  4. Choose whether you want to apply the changes locally or globally. We want to make the value ”Monogram this item?…..No” default for the entire product class “Towels”, so we selected the option “Apply value changes globally”:
  5. Click Save changes. The settings will be saved.

Related pages: