Create, Edit, or Delete Custom Assemblies (TE)

Why Create a Custom Assembly
STACK provides a number of pre-built assemblies that will easily work for most projects, but in certain cases you may want to expand them to include additional items for your trade or build a brand new assembly to represent a unique building condition or material system to fit your exact needs. Creating a custom assembly allows you to incorporate items specific to your work.

Once you've created an assembly, it's available for you to re-use project after project, and you can edit or delete it at any time if needed.

Best Practices
Custom assemblies are created and saved within Custom Libraries under Libraries. We strongly recommend that you create a folder structure there to help organize your custom assemblies and that you give your assemblies detailed names so you can easily find what you need as your library of custom assemblies grows.

TIP
You can click and drag assemblies to easily move them from one folder to another within a Custom Library.

Ways to Create a Custom Assembly

• Create an assembly from scratch.

• Copy a pre-built assembly and customize it to suit your needs.
  This can be an assembly you've previously created in one of your Custom Libraries, or an assembly from the STACK, Quick Start, 1build, BNi, or other assembly library.

Copy and Customize a Pre-built Assembly

Pre-built assemblies in STACK and other vendor-supplied libraries (such as BNi or 1build) cannot be edited directly. These assemblies can be copied to a Custom Library, where they can then be modified as needed. 

TIP
Copying an existing assembly is recommended when only minor additions or adjustments are needed.

NOTE
Only Account Owners and users with the required permissions can copy or edit assemblies. See Custom Libraries for more information.

1. Click Libraries on the main navigation toolbar.

2. Click the Assemblies tab.

3. From the Library dropdown, select the library that contains the assembly to be copied.

4. Locate the assembly.

   1. For assemblies in STACK-supplied or third-party libraries, click the assembly name.

   2. For assemblies in Custom Libraries, click the three dots to the right of the assembly name.

5. Select Save As.

   1. For STACK-supplied or third-party libraries, Save As appears at the bottom of the Assembly Information screen.
      

   2. For Custom Libraries, Save As appears in the menu opened from the three dots.
      

   TIP
   Selecting Duplicate creates a copy of the assembly in the same Custom Library and folder.

6. Enter a new Assembly Name.

7. In the Library dropdown, select the Custom Library where the copied assembly will be saved.

8. When the selected library differs from the source library, an inline set of options is displayed.

   1. Select Independent copy to create a new unique assembly that copies all items used in the assembly into the target library. Copied items are placed in a folder named Copied Assembly Items.

   2. Select Linked copy to create a new assembly that continues to reference the original items.

      NOTE
      Items that already exist in the target library are not duplicated.

9. Locate and select the folder where the assembly will be stored.

   NOTE
   If no folders are available, create a folder in the selected Custom Library before continuing.

10. Make any required edits in the Assembly Details.

11. Click Save. The assembly is saved to the selected library and folder.

NOTE
For estimate calculations to work correctly, items added to an assembly must use a unit of measurement that matches or is compatible with the assembly’s unit of measurement.

Create a Custom Assembly

Creating your own custom assembly gives you complete control over the structure, which items are included, and the formulas of each item.

NOTE
Only Account Owners and users assigned the necessary permission can create an assembly. See Custom Librariess for more info.

1. Click Libraries on the main navigation toolbar.

   

2. Click the Assemblies tab.
3. Click in the Library dropdown and select the Custom Library where you want to create the assembly.
4. Locate the folder where you want to save the assembly. (Create a new folder if needed.)
5. Click the green + that appears when you hover over the folder.
   OR
   Click the three dots next to the folder and select Add New Assembly.

6. Type in a name for the assembly where is says New Assembly (highlighted in blue).

   TIP
    If you need to create multiple assemblies to measure the same building condition in different ways, if can be helpful to include the assembly measurement type at the end of the name so you can quickly identify which assembly you need. Example: Steel Beam - Linear and Steel Beam - Count

7. Enter the assembly information. 
   1. Assembly Number  (Optional)
      You can enter number of your choosing to reference the assembly. The Assembly Number can be used in the Search Items bar to locate the assembly in the Library.

   2. Unit of Measure (Required)
      Choose one of the listed values from the dropdown. This determines the Takeoff Measurement Type that can be used with this assembly. 

      NOTE
      This field is locked as soon as you save the assembly and cannot be changed.

      TIP
       If you're unsure which takeoff measurement type you may use, you can select Each so you can add the assembly to any takeoff and then use different takeoff variables in the formula of each item to get the data you need.

   3. Assembly Description (Optional)
      You can enter a description of the assembly - how it functions or any requirements/specifications. This description will only appear on the Assembly Information screen.
8. Click Save.

Now you can add Required Items and/or Item Groups to the assembly.

Add Required Items

Required Items are a great way to save time and eliminate potential errors in item selections since these items will automatically appear on the Item Reports and Estimates every time you use the assembly. You can add items from any available item library to Required Items.

Using BNi or ibuild items will allow you to apply national or regional cost data to Material and Labor Estimates.

NOTE
For data to compute properly on your estimates, the items added to an assembly must have a unit of measurement that matches/is compatible with the assembly unit of measurement. 

1. Go to the Required Items section and click Add Item.
2. Click the Library dropdown and select the library that contains the item(s) you want to add.
3. Search Library or click on the displayed folders for an expanded list view to locate the item(s) you want to add.
4. Click the green + next to each item you want to add to the assembly.
5. Repeat steps 2-4 to add items from other libraries.

6. Click the Add button.

   TIP
   You can click the dots to the left of each item and drag to reorder the Required Items list.

   TIP
   Use the sort controls in the Name column to sort Required Items alphabetically (A→Z) or reverse alphabetically (Z→A). Items can still be reordered manually by dragging them after sorting. Items can still be reordered manually using drag and drop after sorting.

7. You can now create/add Items Groups.

TIP
Hovering over the info icon next to each Required Item will show the item's coverage rate and clicking the arrow icon will take you to the item's information screen.   

Click the edit (pencil) icon to access the Formula Editor and change the item formula or click the trash icon to remove a Required Item from the assembly.

NOTE
YOUR NOTE TEXT HERE

NOTE: Required Items can have custom formulas. Custom variables for required items will be listed along with other custom variables for items in Item groups, you just won't see the required item on the Edit Assembly screen.

Create Item Groups

Item Groups let you add optional items to your assembly or select an item that's conditional upon selecting an item from another group.

You can create multiple Item Groups, add items from any available item library to any Item Group, and you can add the same items to multiple Item Groups in the same assembly.

TIP
Since you can only choose one option from each item group, we recommend creating additional Item Groups with the same item list if you need to choose additional items from the same group. Example: If you need to choose drywall for both sides of a wall, but are installing different types on each side, create two item groups - one named Side 1 and the other named Side 2 - with the same items to represent each side of the wall.

1. Go to the Item Groups section and click Add Item Group.

2. Type in a name for the item group where is says New Item Group (highlighted in blue).

   TIP
   Consider starting the name of item groups that require a selection with "Choose" and groups that are optional with "Add" Example: Choose Stud Height, Add Headers

3. (Optional) Click where it says Click to add a description below the name and type in a description of the Item Group.
4. Click Add Items to the right of the Item Group name.
5. Click the Library dropdown and select the library that contains the item(s) you want to add.
6. Search Library or click on the displayed folders for an expanded list view to locate the item(s) you want to add.

7. Click the green + next to each item you want to add.

   NOTE
   For data to compute properly on your estimates, the items added to an assembly must have a unit of measurement that matches/is compatible with the assembly unit of measurement. 

8. Repeat steps 5-7 to add additional items from other libraries.
9. Click the Add button.
10. Repeat the entire process to create as many additional Item Groups as needed for the assembly.

TIP
The order you select items will be the order they appear in the Item Group, but you can click the dots to the left of each item and drag to reorder the list.

TIP
Use the sort controls in the Name column to sort Item Group items alphabetically (A→Z) or reverse alphabetically (Z→A). Items can still be reordered manually by dragging them after sorting.

Likewise, if you create multiple Item Groups, they will be listed in the order in which they are created. However, you can click the dots to the left of each Item Group and drag to reorder the list.

TIP
Hovering over the info icon next to each item in an Item Group will show the item's coverage rate and clicking the arrow icon will take you to the item's information screen.   

 Click the edit (pencil) icon to access the Formula Editor and change the Item Formula or click the trash icon to remove an item from the Item Group.

To delete an entire Item Group from the assembly, click the three dots to the right of the Item Group name, select Delete Group, and click the red Delete button to confirm.

Unit of Measurement Mismatches

For data to compute properly on your estimates, the items added to an assembly must have a unit of measurement that matches/is compatible with the assembly unit of measurement.

For example, adding an item with a sq ft unit of measurement to an assembly with a lin ft unit of measurement would cause an error on your estimates because the assembly would be missing the second dimension needed to compute square feet.

There are some cases where item and assembly units of measurement don't match but still compute properly. For example, if the item unit of measurement is linear feet and the assembly unit of measurement is square feet, STACK can calculate the linear feet of the item by taking the perimeter of the polygon used to measure the assembly.

The table below shows item and assembly unit of measurement matches and acceptable “mismatches.”

In cases where the item and assembly units of measurement don't match and aren't an acceptable "mismatch," you can create a custom formula to provide the additional data needed to avoid errors on your estimates.

Acceptable Mismatches - Assembly / Item Units of Measurement 

The Y cells in the table show the item and assembly unit of measurement combinations that work together without the need for custom formulas.

The N cells indicate unit of measurement combinations that will prompt error warnings (example below) on the assembly information screen and produce a ZERO Qty on your estimates unless you create a custom formula.

Edit or Delete a Custom Assembly

You can only edit or delete assemblies in your Custom Libraries; NOT assemblies in the STACK, QuickStart, 1build, BNi, or other assembly libraries.

NOTE
Editing or deleting an assembly will affect ALL projects that contain that assembly.
We recommend that you download and/or Create Snapshot of existing reports, estimates, and estimate worksheets for projects that use the assembly you want to edit or delete, prior to making the changes, so you have a record of the original reports and estimates.

NOTE
Only Account Owners and users assigned the necessary permission can delete an assembly. See Custom Libraries for more info.

Edit an Assembly

1. Click Libraries on the main navigation toolbar.
    

   

2. Click the Assemblies tab.
3. Select the Custom Library that contains the assembly you want to edit from the Library dropdown.
4. Locate the assembly you want to edit and click on the assembly name to open it.
5. Make your desired edits.
   1. You can edit the Assembly Name, Assembly Number, Assembly Details, or Item Group Name - just click in the desired field and type in the new info.
   2. You can add or remove Required Items, Item Groups, or items within an Item Group.
      (Refer to Add Required Items and Create Item Groups above for detailed instructions if needed.)

Delete an Assembly

Click Libraries on the main navigation toolbar.

1. Click the Assemblies tab.
2. Select the Custom Library that contains the assembly you want to delete from the Library dropdown.
3. Locate the assembly you want to delete and click the three dots to the right of the assembly name.
4. Click Delete. 
5. Click the red Delete button to confirm.

Related Articles

What is an Item
Bulk Import Custom Items to STACK
What is an Assembly
Working with Item Formulas in Assemblies
Mastering Custom Formulas
Excel Functions in Formulas

See how others use this feature in the STACK Community.

If you need additional assistance, please Contact Us.