How item tags work
Item tags (also called floor tags or item codes) are short codes that identify selections in a project, so a tag on a floor plan or schedule maps back to the item it represents. The structure is up to you. Some teams tag by Schedule and Type, others by Area, and many combine them. When automatic tagging is on, Gather generates these tags as you add selections, based on the structure you've set up.
This article is an overview of what item tags are and how the pieces fit together. For step-by-step setup, see the related articles below.
What item tags do
An item tag is a short code attached to each selection that ties it to a specific location on the floor plan. Something like PEN-LOB-01 tells you at a glance that you're looking at the first pendant in the lobby.
You'll find item tag settings under your account menu in the lower-left corner, then Settings > Classification > Item Tags.
Automatic tagging is off by default. You turn it on with the toggle at the top of the Item Tags settings page. Once it's on, Gather assigns a tag to every new selection in any project you create going forward. Existing projects aren't affected by this toggle.
How the tag structure works
You decide what your tags look like by choosing which components to include. There are four to choose from:
Schedule code. A short code for the Schedule (for example, LIG for lighting or ACC for accessory).
Type code. A short code for the Type within that Schedule (for example, PEN for pendant or RU for rug).
Area code. A short code for the Area where the selection lives (for example, LOB for lobby).
Sequence number. A number that increments with each new selection. You set the minimum number of digits, anywhere from one to five. Two is the most common, so your first item shows as 01.
You also pick the separator between components: a dash, a dot, or an underscore.
So a tag like LT-PEN-LOB-01 reads as lighting, pendant, lobby, first in sequence.
Where the codes come from
Each part of the tag pulls from a different place in your account.
Schedule and Type codes are set in your Categories settings, under the same Classification menu. Each Schedule has its own code, and within each Schedule, each Type has its own code.
Area codes are set inside each project, in the project's area settings. Open any area, and you'll see its code listed alongside the area name.
Sequence numbers are handled automatically. Gather counts up as you add selections that share the same Schedule, Type, and Area combination.
Defaults and project-level settings
The settings you configure under your account apply as defaults for any new project you create.
Existing projects don't update automatically. To change tag settings for a project that's already underway, open that project's settings and update the structure there. You'll have the option to apply the new structure to selections already in the project.
Manual edits and free-form tags
Even with automatic tagging on, you can edit any tag by hand. If you change a generated tag to something custom, Gather treats it as a free-form tag from that point on for that selection.
If you enter a tag that already exists in the project, Gather will flag it so you can either refresh to pull the next sequence number or keep the duplicate intentionally.
Selections used across multiple Areas
When the same selection belongs to more than one Area, the tag stays the same across all Areas unless you have Area Codes enabled in your tag structure.
