Skip to content

Attribute Input Types ​

Every attribute has a type. The type decides what you fill in on the product edit screen, such as a text box, a switch or a list of options, and which settings the attribute can use. You choose the type when you create the attribute, and you can't change it afterwards.

The types ​

The Attribute Type list offers these types, in this order:

TypeOn the product edit screenUse it for
TextA one-line text box.Short values, such as a model number.
TextareaA multi-line text box, or a text editor when Enable Wysiwyg Editor is on.Longer text, such as care instructions.
PriceAn amount next to your base currency symbol. It must be a number.Extra amounts, such as a recommended retail price.
BooleanA switch that's on or off.Yes-or-no facts, such as whether a jacket is waterproof.
CheckboxOne checkbox for each option. You can tick any number of them.Features, such as the rooms a lamp suits.
SelectA list of options. You pick one.Choices such as Color, Size or Brand.
MultiselectA list of options. You pick one or more.Several values at once, such as the seasons a jacket suits.
DateA date picker.Dates, such as a release date.
DatetimeA date and time picker.Moments, such as the start of a live event.
ImageAn image upload in BMP, JPEG, JPG, PNG or WEBP format.A picture, such as a size chart.
FileA file upload.A document, such as a user manual.

Settings each type supports ​

Some settings can be used only with certain types. For other types they're hidden, greyed out, or ignored when you save:

SettingTypes
OptionsCheckbox, Select and Multiselect. You add the choices yourself.
Input OptionsSelect. The options can show as a dropdown, or as color, image or text swatches.
Use in Layered NavigationCheckbox, Select, Multiselect, Boolean and Price.
Use To Create Configurable ProductSelect.
Enable Wysiwyg EditorTextarea.
Default ValueBoolean.
Input ValidationText.
Value Per LocaleEvery type except Checkbox, Select, Multiselect and Boolean. Checkbox, Select and Multiselect attributes translate their option names instead, and Boolean attributes show Yes or No.

The other settings, such as Is Required and Value Per Channel, appear for every type. Product Attributes describes what each setting does.

What shoppers see ​

When Use in Layered Navigation is on, you can tick the attribute under a category's Filterable Attributes, and it becomes a filter on that category's page. Search results offer every such attribute as a filter. A Price attribute shows as a range slider, and the other types show their options as checkboxes.

For a Select attribute that configurable products use for their variants, Input Options decides how shoppers pick a variant on the product page:

Input OptionsWhat shoppers see
DropdownA drop-down list of the options.
Color SwatchA colored circle for each option.
Image SwatchA small image for each option.
Text SwatchA button with each option's label.

Upload size of Image and File attributes ​

The largest image or file you can upload for an Image or File attribute is set under Configure >> Catalog >> Products. See Attribute.

Released under the MIT License.