Matching inventory
What it's for
A unit shape on a map is only useful once it is linked to an inventory unit: then it shows that unit's stage colour, price and details, and buyers can tap it. Linking happens automatically by unit number. This article explains the rules, how to create inventory from shapes, and how to fix shapes that stay grey.
Before you start
- You need permission to edit site maps. Creating inventory from the map also needs permission to manage inventory, and counts toward your plan's inventory limit.
Match rules
- The shape's label must equal the inventory unit number. Upper and lower case do not matter; spaces inside do.
- When a unit number appears more than once in the project, the unique identifier on the shape must equal the one on the inventory unit.
- Multi-map projects: a map assigned to a section only links to inventory units in that same section.
- Survey numbers, external IDs and areas are never used for matching.
When linking runs
- When you save or publish a map.
- When units are added, edited, deleted or restored in inventory, by form, CSV import, bulk update or API.
- When you add mapped units to inventory or use Fix map & inventory links.
- As a safety check when someone opens the public map or sales layout and a shape is unlinked.
Stage, price and zone changes never need the map to be published again: the published map stores only the shapes, and colours and details come from current inventory.
Create inventory from your shapes
If you drew and labelled shapes before the inventory existed, you do not have to type the units again.
- When publishing, tick Also add mapped units to inventory (off by default), or at any time use More actions → Add mapped units to inventory.
- One inventory unit is created for each labelled shape that has none, with the default Available stage, the project's default unit type, the shape's unique identifier and, on multi-map projects, the map's section.
- Fill prices, areas, zones and other details afterwards with CSV upload or by editing each unit.
Existing units are never overwritten — their price, stage, zones and notes stay as they are. If an existing unit has no section and the map has one, only the section is filled in.
Fix shapes that stay grey
- Run More actions → Fix map & inventory links. It is safe to run any time: it merges duplicate stub units created by mixing map-first and CSV work, relinks every shape, adds missing units when you may manage inventory, and refreshes the live map. It does not change prices, stages, zones or notes.
- Still grey? Compare the shape label and the unit number character by character (Select tool shows the label).
- For repeated numbers, check the unique identifier on both sides.
- On multi-map projects, check the unit's section matches the map's section.
- Check the inventory unit was not deleted, and that the label has no
&.
- Save the map again.
Tips and common questions
- Deleting a unit from inventory leaves its shape on the map, unlinked. Delete or relabel the shape.
- Two shapes with the same label — each needs its own unique identifier, or one of them will not link.
- Inventory units without a shape still appear in the inventory list and filters; they just are not on the map.
- CSV import links existing shapes as soon as you commit.
Related: Unit mapping · Unit labels & list · Section paths · Inventory basics