QTOTag Freemium
QTOTag assigns catalog items (price-list rows) to your Revit elements — this is how you tell QTO which priced items belong to each element. By default it works by type: a tag applied to a selected type propagates to every instance of that type. QTOCompute then turns those assignments into quantities and totals.
Assigning by type propagates to all instances of that type — usually what you want. Switch to Only the selected instance(s) for one-off exceptions.
Where this fits
QTOSetup loads your price lists and marks which are active. QTOMappings defines how each quantity is derived per category. QTOTag attaches the priced items to elements. Finally QTOCompute computes the quantities and writes the results.
Prerequisites
- QTOSetup must have run on the active project.
- At least one price list must be marked active in the Price lists tab of QTOSetup, otherwise QTOTag stops with "Select at least one price list as active…".
How to run
Select one or more elements in Revit, then on the AEC.codes ribbon tab click QTOTag. If nothing is selected when you launch it, the add-in asks you to pick elements first ("Select elements to tag, then press Finish").
Apply to
The radio group at the top controls how far a tag propagates:
- All instances of selected types (default) — every instance of each selected element's type.
- Only the selected instance(s) — just the elements you picked.
- All instances of selected types in current view — instances of those types visible in the active view.
The title bar shows the current selection (e.g. 3 element(s) selected — 1 unique type(s)).
If the selected types already have different tags, a Mixed selection banner
warns that Save will overwrite all of them with whatever is in the panel.
Search Catalog (left panel)
- Cerca in: — the price-list picker. Choose which active price list to search; the add-in remembers your last choice per project.
- Search box — type to find items (matches all words you enter). Enter at least 3 characters; below that the panel shows "Enter at least 3 characters".
- Super-chapter / Chapter / Sub-chapter — cascade filters that appear once a search returns results, to narrow the list.
- Results — each row shows the code, description, and unit of measure (UoM). The list is capped; refine the filters if you see "Showing first N of M".
- Add Selected (or double-click a result) — move the highlighted item into Assigned Items.
Assigned Items (right panel)
This is the draft list of items that will be written to the elements. Each item has:
- Value param — which QTO quantity this item is measured against (e.g.
AEC_QTO_Areafor a m² item). The list is limited to the quantities you mapped in QTOMappings for the selected categories (it falls back to all eight if none are mapped). - Modifier — an optional adjustment applied to this item's quantity (up to 64 characters). An invalid entry is flagged with a red border.
- Work category — a three-level cascade (e.g.
Building › Walls › Internal Walls) from the project's Work Categories. - Phase — which work stage the item belongs to, from the project's work stages. The add-in remembers your last choice for new rows. Shown only when stages are configured.
You can add the same code more than once — for example to bill it under different modifiers, work categories, or phases. Tick the checkbox on one or more items and use Remove Selected to drop them.
Saving
Two save buttons in the footer write the assigned items to the elements resolved by the Apply-to mode, in a single Revit transaction:
- Save — writes the tags and marks the elements as partial (tagged, quantities pending QTOCompute).
- Save and Hide — writes the tags and sets the status to hidden, so the elements drop out of the "needs tagging" indicators.
Cancel closes without writing anything.
Clearing tags
Clear All empties the assigned list and removes the QTO tag from the selected elements. It asks for confirmation first ("Clear all assigned items for the selected elements?") and closes the dialog on confirm.
Troubleshooting
"Select at least one price list as active…"
No price list is active for this project. Open QTOSetup → Price lists and tick at least one Active.
"The catalog library is empty."
No price list has been loaded yet. Load one from the Data source tab in QTOSetup.
The search shows no results
You need at least 3 characters, and the search runs against the price list chosen in "Cerca in:". Check the picker and your filters.
A Modifier field has a red border
The modifier is invalid. Fix it before saving.
"Mixed selection" banner
The selected types currently carry different tags. Saving replaces all of them with the items in the panel.