Diagram Editor¶
The editor is where you transform a flat image into an interactive diagram. Open it by clicking any diagram from the list, or by clicking Save on the create screen.
Layout¶
The editor is a two-column workspace:
- Canvas (left) — your diagram image with the hotspot overlay.
- Inspector (right) — properties of the currently selected hotspot: label, mapped product, mapped variant, custom display title.
A toolbar at the top of the canvas switches between modes:
| Mode | Shortcut | What it does |
|---|---|---|
| Select | V |
Move and resize existing hotspots |
| Draw rectangle | R |
Click-and-drag a rectangle hotspot |
| Draw point | P |
Click to drop a point hotspot |
| Pan | Space (hold) |
Drag the canvas |
| Zoom | scroll | Zoom canvas under cursor |
Drawing hotspots¶
Rectangle hotspots¶
Best for parts with a clear bounding box (a wheel, a button, a panel).
- Press
Ror click the rectangle tool. - Click-and-drag from one corner to the opposite corner of the part.
- Release to commit. The hotspot is selected and its inspector opens.
Point hotspots¶
Best for small parts where a rectangle would feel cluttered (a screw, a connector, an indicator light).
- Press
Por click the point tool. - Click the location once. The point is dropped and selected.
Editing a hotspot¶
- Drag the body to move.
- Drag a corner handle to resize (rectangles only).
- Press Delete or Backspace to remove the selected hotspot.
- Use Cmd/Ctrl + Z / Shift + Cmd/Ctrl + Z for undo / redo.
Mapping a hotspot to a product¶
This is what makes the hotspot interactive on the storefront.
In the inspector for the selected hotspot:
- Use the Product picker to search by title or SKU. Pick the matching Shopify product.
- If the product has variants, the Variant dropdown becomes active. Pick the specific variant the hotspot represents.
- Leave it on "Any variant" if the hotspot represents the product as a whole and shoppers should see the variant picker in the popup.
- Pick a single variant to lock the hotspot to that exact SKU — no picker shown in the popup.
The app records a snapshot (price, compare-at price, image, SKU) at mapping time, so the storefront can render an accurate first paint even before live data loads.
Labels and display titles¶
| Field | Where it shows | When to fill in |
|---|---|---|
| Label | Hover tooltip on the image; bold title in the side panel and popup | Always recommended — short and friendly ("Toe buckle", not "TC-447-A") |
| Custom display title | Overrides the product name shown in the popup body | Rarely needed. Use it when the Shopify product name is too long or technical to surface to shoppers |
Label takes priority over product title
If a hotspot has a label, the storefront shows the label as the bold title for that part. If the label is empty, the storefront falls back to the underlying product's title. This keeps the side panel readable even when many parts share the same base product.
Saving¶
The editor auto-saves every few seconds while you work. The header shows a Saved indicator after each change. There's no separate "publish" step — once a hotspot is saved on a diagram that's assigned to a product, it's live on the storefront.
Keyboard shortcuts (full list)¶
| Action | Shortcut |
|---|---|
| Select tool | V |
| Rectangle tool | R |
| Point tool | P |
| Pan canvas | hold Space and drag |
| Undo / Redo | Cmd/Ctrl + Z / Shift + Cmd/Ctrl + Z |
| Delete hotspot | Delete or Backspace |
| Zoom in / out | scroll wheel |
| Fit to canvas | 0 (zero) |
| 100% zoom | 1 |