This document will detail how to add item attributes to your storefront to further customize the item detail pages.

Item Attributes

Item attributes are item specific information that are additional to the defaulted item details. Attribute allow you to customize the data you are assigning to your items. Once an item attribute is created, a corresponding field will appear within the first tab of the item editor.

Adding a new Item Attribute

Storefronts Themes that do not have the Visual Builder integrated

Step 1 - Editing the Template

So, for example, let's say you wanted to assign a youtube video to be displayed on the item detail page.

Navigate:
 

To do this you would edit the template "templates/template_item.vm" and in the top commented section, you would add the following line:

## uc:item-attribute-html="youtube"

The inclusion of the new item attribute wil appear like this in the template:
 

Next we need to add to the template the velocity code snippet that displays the new attribute in the template pages:

<center>
#if ($item.getAttributeValue("youtube1") != "")
<h2>Product Video:</h2>
##<div class="videowrapper">
  $item.getAttributeValue("youtube1")
##</div>
#end
</center>

Step 2 - Configuring the attribute value for a specific item

After saving the changes to the template, navigate to the item editor and scroll down to the "Storefront Content" section of the first tab  in the item editor.

The new 'youtube' attribute will appear along the left side like this:

And here's the new 'youtube' attribute field configured with the youtube video 'embed' code:

Step 3 - Viewing the new attribute in the storefront item page

Here's the view of the item page for thew item that has the Youtube embed code configured:

Storefronts Themes that have the Visual Builder integrated

Follow these steps for Elements theme, which has the visual builder.

Step 1 - Navigate To And Edit The Item Page To Which You Wish To Add The Attribute

Navigate to the page you want to include the attribute and then click  the edit button tin enter the Visual Builder:

Step 2 - Click the Hiarchy menu choice along the right side of the page

Clicking the Hiarchy menu choice will open the hiarchy panel, scroll through the elements until you have the section you wish to add the new attribute highlighted.

Step 3 - Add the Item Attribute Element

Once you have the appropriate section of the page highlighted, click the "Add Element" button then search for "Item Attribute".