> ## Documentation Index
> Fetch the complete documentation index at: https://docs.speckle.systems/llms.txt
> Use this file to discover all available pages before exploring further.

# Markups

> Draw and annotate your models to give clear feedback.

<Frame>
  <img src="https://mintcdn.com/speckle/rfxm_j2H-JbVKkhv/images/3d-viewer/markups.webp?fit=max&auto=format&n=rfxm_j2H-JbVKkhv&q=85&s=3a1dd5a95600ed2183f04dc07a3b4841" width="2052" height="1512" data-path="images/3d-viewer/markups.webp" />
</Frame>

## What are markups?

The Markup tool lets you sketch, draw shapes, and add text notes directly on your model in the Speckle 3D viewer. Circle problem areas, add arrows to show where things should move, or write quick notes, all without leaving Speckle.

<Info>Markups are available in all Speckle plans, including Free.</Info>

## Creating a markup

<Steps>
  <Step title="Set the view">
    Open a model in the 3D viewer and position the camera.
  </Step>

  <Step title="Open Markup">
    Click the Markup button in the bottom toolbar.
  </Step>

  <Step title="Add annotations">
    Use pen, shapes, and text tools to capture feedback.
  </Step>

  <Step title="Style output">
    Adjust color, stroke width, and line style as needed.
  </Step>

  <Step title="Save or export">
    Save as a view for collaboration, or export as an image immediately.
  </Step>
</Steps>

<CardGroup cols={3}>
  <Card title="Pen" icon="pen">Freehand sketching and circling.</Card>

  <Card title="Shapes" icon="shapes">
    Rectangle, circle, arrow, line, and polyline.
  </Card>

  <Card title="Text" icon="font">Place written notes directly in the view.</Card>
</CardGroup>

<div
  style={{
position: "relative",
paddingBottom: "66.67%",
height: 0,
overflow: "hidden",
}}
>
  <iframe
    src="https://player.vimeo.com/video/1138063850"
    allowFullScreen
    loading="lazy"
    style={{
  position: "absolute",
  top: 0,
  left: 0,
  width: "100%",
  height: "100%",
}}
  />
</div>

<AccordionGroup>
  <Accordion title="Can I add multiple annotations in a single markup?">
    Yes. You can draw as many shapes, lines, and text notes as needed before saving or exporting.
  </Accordion>

  <Accordion title="Can I create markups on mobile or tablet devices?">
    Yes. The markup tools work on touchscreen devices. Drawing and text entry use your device’s native touch and keyboard input.
  </Accordion>
</AccordionGroup>

## Saving markups as views

When you save a markup, it's stored as a [Saved view](/3d-viewer/saved-views). This captures:

* Your annotations
* Camera angle and position
* Visible objects and filters
* Complete model state

Saved views are accessible from the Views panel on the left. By default, saved views are visible to anyone with access to the model, so your markups are instantly accessible to others.

You can organize your saved markup views into folders by review round, discipline, or topic for more straightforward navigation.

<Note>
  Saving a markup requires the **Contributor** project role or higher. Users
  with the **Reviewer** project role can still use Markup tools, but can only
  export as an image.
</Note>

<AccordionGroup>
  <Accordion title="Do saved markups change if the model is updated?">
    Saved markup views restore the viewer configuration that was saved, including camera, visibility, and annotations. If the underlying model changes between versions, the view will still open, but what you see may differ from what it was when the markup was created.
  </Accordion>

  <Accordion title="Do markups affect the model or its geometry?">
    No. Markups are stored as overlays on top of the viewer. They never modify
    model geometry or properties.
  </Accordion>

  <Accordion title="What happens to markups if I delete a saved view?">
    Markups are stored inside the saved view. If you delete the view, its annotations are removed as well.
  </Accordion>
</AccordionGroup>

## Exporting markups as images

You can export a markup without saving it to the project:

* **Download as image:** Get a PNG file for sharing outside Speckle.
* **Copy image to clipboard:** In the ··· menu, there's an action to copy the markup to your clipboard to paste directly into emails, Microsoft Teams, or other tools.

These export options work whether you have edit permissions on the project or not.

## Permissions

**Anyone viewing a model** can:

* Use the markup tool
* Export markups as images or to the clipboard

**Users with the Contributor project role** can also:

* Save markups to the model as saved views

<AccordionGroup>
  <Accordion title="Do unsaved markups appear for other users?">
    No. Unsaved markups are only visible in your current browser session. Other
    users will not see them unless you save the view.
  </Accordion>
</AccordionGroup>