## Placing a pin

Clicking the picture does not place a pin on its own. Turn the pin
tool on first, then click.

**Pin tools** sits at the top of the canvas: an arrow for selecting,
and a map-pin button that turns pin placing on. Press the map-pin
button, or **right-click anywhere on the picture**, and the cursor
becomes a cross-hair. Now each click on the image drops a pin and
opens a small card asking for its label.

The tool is *sticky*: it stays on until you turn it off, so a run of
pins is a run of clicks rather than a trip back to the toolbar between
each one. **Escape**, or another right-click, turns it off again —
first closing the label card if one is open, then the tool.

Drag an existing pin to move it. On a 360° scene, look around first
and place the pin while you are facing the thing it refers to — the
pin is anchored to that direction.

## Opening a pin to write in it

Selecting a pin opens the **Pin** panel on the right: its label,
colour, size and context. That panel is about the marker.

What a learner *reads* lives somewhere else, and it takes one more
press. In the Pin panel, under **Content**, choose **Content panel
preview**. The pin's card floats over the scene, exactly as a learner
gets it, at the width they get it.

Then, to write:

- **click any block on that card** — a paragraph, a picture, a
  callout — and the block editor opens beside it, with that block
  selected;
- on a pin with nothing in it yet there are no blocks to click, so the
  card offers **Add a block** instead.

There is no separate Edit button, and that is deliberate: clicking the
thing you want to change says which one, where a button could not.

The two panels are separate on purpose. The preview answers *what does
a learner see*; the editor answers *how do I change it*. Closing the
preview closes both. The scene underneath never moves or narrows while
they are open, so a pin you place after closing them lands where you
clicked.

## Styling

Each pin has a colour and a display style. Use colour with intent: if
every pin in a scene is a different colour, the colour has stopped
carrying information. A common pattern is one colour per context.

Pins can also be numbered. Numbers are assigned in order and close up
automatically if you delete one, so there is never a gap in the
sequence a learner sees.

## Editing several at once

Hold **Shift** and click to select multiple pins, or drag a selection
box. With several selected you can change their context, colour or
visibility together, or delete them in one action. This is much faster
than fixing twenty pins one at a time after you decide the scheme was
wrong.

## What goes inside a pin

Pins hold blocks: text, headings, images, video, audio, galleries,
compare, reveal, quotes, checklists, callouts, banners, buttons, stats,
key facts, dividers, spacers, embeds, resource lists, accordions and
scene links. Add what the point needs and stop —
a pin the learner has to scroll through twice is usually two pins.

The one block a pin cannot hold is a **menu**. A menu is a way around a
page, and a pin is somewhere you have already arrived.

It is the same block editor a page node and a scene use, so a block behaves
the same wherever you built it.

Two things about working in it are worth knowing.

**Deleting a block asks first.** It names the kind of block and says the
delete cannot be undone, because on a pin the blocks *are* the content and
nothing puts one back — see [Undo a change in the
editor](/support/articles/undo-a-change-in-the-editor).

**Pasting into a text block keeps its formatting.** Bold, italics, bullet
and numbered lists and links all survive a paste out of a document or a web
page, so you no longer have to redo by hand what you had just brought in.
Everything else is reduced to plain words on the way in.

## A link pin, and where it opens

A pin can be a **link** to an address outside the experience. It opens in a
new tab by default, which is usually right — but a link into another page of
the same course, or a form the learner is meant to finish and come back from,
reads better in the window they are already in, and the pin can now say
which.

## If you built something before 27 August 2026

⚠️ **Pins written before then have been repaired.** A pin used to have
a plain **description** box and a single picture of its own, and
neither was ever shown to a learner — a pin whose only content was
that box did not open at all. Both have been moved into real blocks
inside the pin, so that content now appears. **It is worth opening an
experience you built before then and reading its pins**, because some
of them are showing text a class never saw.

If you signed up after that date, this cannot affect anything you have
made.