Item Attributes let you add your own fields to the items in a library, so you can categorize and track items the way your business works. You name each attribute, choose what type of value it holds, and then fill in a value on each item. Common examples include Phase, Cost Code, CSI Code, SKU, Trade Category, or Warranty Period.
Item Attributes are set up for each library. Every item in that library shows the library's attributes, and each attribute is optional, so you can leave a value blank.
What to Know
- Item Attributes are library-specific. An attribute created in one library does not appear in other libraries unless you copy it there.
- Only users with permission to edit the library can add, edit, copy, or delete attributes.
- Item Attributes apply to items only. They are not available on assemblies, library takeoffs, or projects.
- Attribute values are included when you export items from a library to CSV and can be updated when you import items.
- Values you enter are not translated. They appear exactly as you typed them.
Attribute Types
Each attribute holds one type of value. Choose the type when you create the attribute.
| Type | What It Holds |
|---|---|
| Text | A single line of free text. |
| Number | A number. Decimals are allowed. |
| Currency | A number shown as a currency amount. |
| Date | A date, chosen from a date picker. |
| Date and Time | A date and a time. |
| Checkbox | Yes or No. |
| Single-select | One value from a list of options you define. |
| Multi-select | One or more values from a list of options you define. |
Add an Item Attribute to a Library
- Click Libraries on the main navigation toolbar.
- Select the library from the Library dropdown.
- Click the gear icon next to the Library dropdown to open the library settings.
- Scroll to the Item Attributes section.
- Click Add Attribute.
- Enter an Attribute Name. This is the label shown on each item.
- Select the Type of Field.
- If you chose Single-select or Multi-select, add the options you want users to choose from.
- Click Save. (Save is available once both Attribute Name and Type of Field are filled in.)
The attribute appears, blank, on every item in the library.
TIP
Drag attributes up or down in the Item Attributes list to change the order they appear on each item.
Enter Attribute Values on an Item
- Click Libraries on the main navigation toolbar.
- Click the Items tab.
- Select the library from the Library dropdown.
- Click the item you want to update.
- In the Item Attributes section, below Item Details, enter or select a value for each attribute you want to fill in.
- Click Save. (If you click Cancel, your changes will NOT be saved.)
NOTE
If you have permission to edit the library, you can also click Add Attributes in the item's Item Attributes section to create a new attribute without leaving the item. The new attribute is added to the library and appears, blank, on every other item in that library.
Edit an Item Attribute
You can change an attribute's name, its options, and its order from the Item Attributes section of the library settings. Renaming an attribute does not change the values already entered on items.
IMPORTANT
Removing an option that items are using, can clear values on those items. STACK shows how many items use the attribute and asks you to confirm. This cannot be undone.
Copy an Item Attribute to Another Library
If your company uses more than one library, you can copy an attribute instead of creating it again.
- Open the library settings and go to the Item Attributes section.
- Click Copy on the attribute you want to copy.
- Select the destination library from the dropdown.
Libraries that already have an attribute with the same name are not listed. - Confirm the copy.
The attribute's name, type, and options are copied. Values are not copied, so items in the destination library start with the attribute blank. The copy is independent, so changes to one library's attribute do not affect the other.
Delete an Item Attribute
- Open the library settings and go to the Item Attributes section.
- Click Trash Icon on the attribute you want to remove.
- Review the Delete Attribute window, click Delete to confirm, or Cancel to keep the attribute.
IMPORTANT
Deleting an attribute removes it, and its values, from every item in the library. This cannot be undone.
Item Attributes in Import and Export
When you export items from a library, the CSV includes one column for each attribute in that library. The column header is the attribute name.
When you import items, you can use those same columns to set or update attribute values.
- For Single-select attributes, enter the option name exactly as it appears in the library.
- For Multi-select attributes, enter the option names separated by a delimiter.
- If a column header does not match an attribute in the library, the import stops and lists the column names that did not match.
- If a select value does not match one of the attribute's options, that row is skipped and listed in the import results. The rest of the file still imports.
TIP
Export your items first and use that file as a template. Its attribute columns already match the attribute names in your library.
Use Item Attributes in the Estimate Worksheet
Item Attributes can be added as columns in the Estimate Worksheet. They are not shown by default. Once added, you can filter, sort, and group by an attribute, and the columns are saved as part of a saved view.
NOTE
Attribute values cannot be edited in the Estimate Worksheet. To change a value, edit the item in the library.
Related Articles
What is an Item (TE)
Create, Edit, or Delete Custom Items
Import Items into a Library (TE)
Export Your Custom Items from STACK
Project Libraries (TE)
See how others use this feature in the STACK Community.
If you need additional assistance, please Contact Us or email build-support@stackct.com.
Comments
Please sign in to leave a comment.