> For the complete documentation index, see [llms.txt](https://docs.paragontruss.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.paragontruss.com/markup/how-to-guides/annotate-drawings.md).

# Annotate Drawings

Add text and shapes to a drawing, edit the drawing's own text and linework, leave notes for the customer, and manage the files and pages in a job. Most of these tools are in `Document Tools` at the top of the left sidebar.

## Document Tools buttons

The first row of icons is always shown, even when `Document Tools` is collapsed. Hover over an icon to see its name.

<figure><img src="https://584518559-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FvjCN6yGVi9EoF95QNivD%2Fuploads%2FLsllsbYEmwHDW47hwVam%2Fmarkup_upload_annotation_image.png?alt=media&#x26;token=b8f947e3-4c4f-4439-8683-4a639e9f8e27" alt="The Document Tools section of the Markup left sidebar, with its icon rows and Annotation Options"><figcaption><p>Document Tools</p></figcaption></figure>

| Button                                                                                                                                                                                                               | What it does                                                                                                                                                |
| -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------- |
| <img src="https://raw.githubusercontent.com/google/material-design-icons/master/png/file/cloud_upload/materialicons/24dp/2x/baseline_cloud_upload_black_24dp.png" alt="Add Items icon" data-size="line"> `Add Items` | Adds files to the job. See "Add files to a job" below.                                                                                                      |
| `Delete Document`                                                                                                                                                                                                    | Deletes the whole PDF you're viewing, after you confirm.                                                                                                    |
| <img src="https://raw.githubusercontent.com/google/material-design-icons/master/png/content/add_circle/materialicons/24dp/2x/baseline_add_circle_black_24dp.png" alt="Add Page icon" data-size="line"> `Add Page`    | Adds a blank page after the current page.                                                                                                                   |
| `Remove Page`                                                                                                                                                                                                        | Deletes the current page. It's unavailable when the PDF has only one page.                                                                                  |
| `Replace Components`                                                                                                                                                                                                 | Replaces component designs with new files of the same name. The notes on each one are preserved.                                                            |
| `Reorder Documents`                                                                                                                                                                                                  | Changes the order of the job's PDFs.                                                                                                                        |
| `More Options`                                                                                                                                                                                                       | Opens a list of every PDF and page in the job, so you can delete several at once or regenerate several TDDs. See Delete or Regenerate Several PDFs at Once. |
| `Fit To Page`                                                                                                                                                                                                        | Fits the page to the window.                                                                                                                                |

Under `Annotation Options`, the next two rows act on the annotations you've selected or on the page:

| Button                                                                                                                                                                                                                                                          | What it does                                                                                                         |
| --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | -------------------------------------------------------------------------------------------------------------------- |
| `Bring To Front`, `Bring Forward`, `Send Backward`, `Send To Back`                                                                                                                                                                                              | Move the selected annotations in front of or behind others.                                                          |
| `Horizontally Align`, `Horizontally Distribute`, `Vertically Align`, `Vertically Distribute`                                                                                                                                                                    | Line up or space out the selected annotations.                                                                       |
| `Save Job`                                                                                                                                                                                                                                                      | Saves your changes now. Markup also saves when you change page or document, seal, return, and close the tab.         |
| `Reset Page`, `Reset Document`                                                                                                                                                                                                                                  | Remove your own annotations from this page or this PDF, after you confirm. Other people's annotations are preserved. |
| `Undo`, `Redo`                                                                                                                                                                                                                                                  | Undo or redo changes on this page.                                                                                   |
| <img src="https://raw.githubusercontent.com/google/material-design-icons/master/png/editor/insert_photo/materialicons/24dp/2x/baseline_insert_photo_black_24dp.png" alt="Place Object icon" data-size="line"> `Place Object`                                    | Adds text or a shape. See "Add text" below.                                                                          |
| <img src="https://raw.githubusercontent.com/google/material-design-icons/master/png/image/add_photo_alternate/materialicons/24dp/2x/baseline_add_photo_alternate_black_24dp.png" alt="Upload Annotation/Image icon" data-size="line"> `Upload Annotation/Image` | Adds a .png or .jpg image, or the annotations saved in a .json file.                                                 |

## Add text

### Step 1 - Click `Place Object`

### Step 2 - Click the text box button under Basic Shapes

### Step 3 - Enter your text, such as `Replace web W3 with 2x4` in `Type Your Content Here`

The `Edit Annotation` window also sets the font size, color, bold, italic, and underline.

### Step 4 - Click `Place Text`

The text is placed in the middle of the page. Drag it to reposition the annotation.

{% hint style="success" %}
Tip

To change text later, double-click it to open `Edit Annotation`, or click it once it's selected to type in place. While typing in place, press Enter to finish, `Shift + Enter` for a new line, or `Ctrl + E` to open `Edit Annotation`.
{% endhint %}

## Add a shape

### Step 1 - Click `Place Object`

### Step 2 - Click a shape under Basic Shapes, such as the callout or the arrow

The shapes include a callout, an arrow, solid and dashed lines, clouds, rectangles, and ellipses, in black or red, filled or hollow. Each is placed in the middle of the page at half size. Drag it into place, and drag its corners to resize it.

## Edit the drawing's own text and linework

The text and lines that come with a drawing are system annotations. They're locked until you turn on editing. You might edit them to remove a member for a repair, for example.

### Step 1 - Click `Template Tools`

It's under `Annotation Tools`.

### Step 2 - Click `Enable System Annotation Editing`

The button changes to `Disable System Annotation Editing`, which if clicked, locks them again. It's shown only if your account has the `seals-signatures-markup` permission.

### Step 3 - Select the text or line you want to change

Lines are harder to grab than text, so zoom in first. You might need to select each line on its own.

## Leave notes for the customer

### Step 1 - Enter your notes, such as `Added a 2x4 scab to W3` in `Truss Design Modifications`

Each PDF has its own notes. They're saved when you click away, and they're sent to the customer: the return email lists each PDF's notes, and a rejection email is made of them. See [Sealed Job Email](https://docs.paragontruss.com/markup/reference/sealed-job-email).

## Add files to a job

Use this to add pages such as a legal or disclaimer sheet, or to see files that came with the job but aren't shown. A job in Review can include files such as photos of damage. Markup doesn't show a file until it's in `Components to Seal` or `Other PDFs to Seal`, even if it won't get a seal.

### Step 1 - Click `Add Items` and choose the files

You can choose several files, or one .zip file. The `File Manager` opens with three columns: `Components to Seal`, `Other PDFs to Seal`, and `Miscellaneous Files`.

<figure><img src="https://584518559-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FvjCN6yGVi9EoF95QNivD%2Fuploads%2F2ZsFrWr3DHdp4s6aZZAs%2Fmarkup_file_manager.png?alt=media&#x26;token=f3ad200b-97bd-4f59-b147-0f9f7be387d8" alt="File Manager with Components to Seal, Other PDFs to Seal, and Miscellaneous Files columns, the arrow buttons between them, and the Confirm button"><figcaption><p>The File Manager</p></figcaption></figure>

### Step 2 - Select a file in `Miscellaneous Files` and click the left arrow

The file moves to `Other PDFs to Seal`. The right arrow moves it back, and the double arrow (`Move All`) moves every PDF.

### Step 3 - Click `Confirm`

Markup then sorts the whole job: the cover page first, then the components by name, then the other PDFs by name, and the back page last. This replaces any order you set with `Reorder Documents`.

## The grid page

After you seal a job, the cover page PDF (`CoverPage.pdf`) has a grid page after each cover page. It lists every truss in the job, up to 50 per page, with its URL, P-number, and seal date. To see it, click the arrow next to `CoverPage.pdf` in the document list.

<figure><img src="https://584518559-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FvjCN6yGVi9EoF95QNivD%2Fuploads%2FWlhQvMF8lOzt6IS9Q40k%2Fmarkup_grid_page.png?alt=media&#x26;token=3d95d402-f0c4-49fa-8dc9-232ad623f79e" alt="The grid page, page 2 of CoverPage.pdf, listing each truss with its URL, PNumber, and Seal Date"><figcaption><p>The grid page</p></figcaption></figure>

## Download from Markup

The icons under `Download Options` download what's in the job right now:

| Button                                                 | Downloads                                                                 |
| ------------------------------------------------------ | ------------------------------------------------------------------------- |
| `Download all PDFs as separate documents`              | Every PDF, separately. They're digitally certified if you sealed the job. |
| `Download an unsecured merged PDF with my annotations` | One merged PDF that isn't digitally certified.                            |
| `Download miscellaneous files`                         | The job's miscellaneous files.                                            |
| `Download all files for the selected component`        | The current component's design files.                                     |
| `Copy PDF URL to Clipboard`                            | A link to the current PDF.                                                |

For a job with more than 100 PDFs, Markup emails you when the download is ready. To download the customer's finished files, see [Download a Job's Files](https://docs.paragontruss.com/review/how-to-guides/download-a-jobs-files) in the Paragon Review docs.

## See or hide other people's annotations

Annotations from other people show colored outlines, and annotations from another organization have dashed outlines. `Visible User Annotations`, under `Annotation Tools`, lists everyone with annotations on the current page. Click the x on someone's name to hide their annotations. This only changes what you see.


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation by asking a question.

Perform an HTTP GET request on the following URL with the `ask` and `goal` query parameters:

```
GET https://docs.paragontruss.com/markup/how-to-guides/annotate-drawings.md?ask=<question>&goal=<user_goal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is what the user is ultimately trying to achieve, the reason they need the answer. Sharing it helps GitBook give you a better, more relevant answer. A goal is most helpful when it describes the outcome the user wants rather than restating the question. For example, with `ask=how do I create an API token`, a goal like `automate deployments from our CI pipeline` lets GitBook tailor the answer to that use case.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
