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

# Drawings

Upload and organize drawings on the web, then download them to your phone so the plans are with you on site, even without signal.

Drawings live under the **Field** module. You upload and organize them on the web at [Field > Drawings](https://app.cogram.com/dashboard/reports/drawings), and your team downloads them to their phones to browse on site and pin [observations](https://docs.cogram.com/field/observations.md) to them.

## Managing drawings on the web

### Uploading drawings

Click **Upload Drawings** on the Drawings page and pick your files. Cogram reads each sheet's title block and fills in the drawing number, date, [discipline](https://docs.cogram.com/field/drawing-disciplines.md), and revision code automatically. You can also type a revision code in the upload dialog to apply one code to the whole upload, useful when a package all goes out at the same revision. A sheet without a readable code has no revision until you set one; see [Revisions and versions](https://docs.cogram.com/documents/revisions-and-versions.md).

Each PDF can have up to 1000 pages. A longer PDF isn't processed: its upload shows as **Failed** with the page count.

Large uploads keep going after you close the dialog, and the dialog lists each upload with its status. If an upload stops partway or some pages fail, it shows as **Failed** with a note. Upload the same file again, with the same drawing set and revision code, and Cogram adds only the missing pages, without a second revision of the sheets that already made it in. Uploading a file while that same file is still processing in the project is refused; wait for the first upload to finish.

Uploading the same drawing number again creates a new revision, so the current sheet stays on top and older revisions remain available. A revision code that was already issued on a sent [transmittal](https://docs.cogram.com/documents/document-transmittals.md) is frozen: a re-upload carrying it lands as an unnamed revision instead, keeping the issued record intact.

### Organizing with drawing sets

Drawing sets group sheets into packages, like "Bid Set 2026" or "IFC Set". Click **Manage sets** to create sets and assign sheets. Sets are what your team downloads to their phones, so group sheets the way people will need them on site. A set belongs to one project.

### Bulk-editing drawings

When several drawings need the same discipline, drawing set, or date, update them in one step:

1. Select the drawings with the checkboxes in the first column.
2. Click **Edit (N)** in the toolbar that appears above the table.
3. Fill in any combination of **Discipline**, **Drawing Date**, and **Drawing Set**.
4. Click **Save**.

Fields you leave blank are left alone on every selected drawing, not cleared. To remove a value from a drawing, open that drawing individually and clear the field there.

If your selection spans multiple projects, the Drawing Set field is disabled ("Selected drawings span multiple projects"); discipline and date still work across projects. If some drawings cannot be updated, the dialog keeps the successful ones saved and lists the failures so you can fix and retry only those.

### Who can manage drawings

Editing (bulk and single) is available to project Owners and Leads in their projects, and to Org Admins and Org Owners across all projects. Deleting is stricter: only a project Owner or Lead can delete a drawing. Members and Viewers can view and download. See [Project roles](https://docs.cogram.com/projects/project-roles.md).

## Drawings on your phone

### Downloading sets for offline use

Signal is unreliable on site, so download what you need in advance:

1. Open the **Drawings** tab in the mobile app and pick the project.
2. Tap the download icon on a drawing set. A progress bar shows how many sheets are done.
3. Downloaded sets offer **Refresh** (fetch the latest revisions) and **Remove from offline**.

You can also open a set and long-press sheets to select several and download only those.

Each sheet shows its state at a glance: a green check (downloaded), a refresh icon (a newer revision exists), a cloud icon (not downloaded), or a cloud-off icon (not downloaded while you are offline).

{% hint style="info" %}
The app manages its own storage. If space runs low, it removes older unpinned sets and tells you how much it freed. Sets you keep downloaded stay put.
{% endhint %}

### Browsing on site

Inside a set, filter sheets by discipline with the chips at the top, switch between list and grid view, or search. Open a sheet to pan and zoom.

Red pins on a sheet are existing observations; tap one to open it. Long-press anywhere on the sheet to capture a new observation pinned to that spot. See [Capture observations](https://docs.cogram.com/field/observations.md).

## Drawings in the document register

Drawings also appear as rows in [Documents](https://docs.cogram.com/documents/documents.md), next to the project's files, with their current revision and status. From the register you can download them or select them into a [transmittal](https://docs.cogram.com/documents/document-transmittals.md), the formal, numbered record of what was issued.

The register's rail has a **Drawings** node. Open it and the whole page accepts drops: drag PDFs anywhere onto it and the drawings upload dialog opens with those files already staged, title blocks read as usual. The document scopes in the rail behave the same way for ordinary files.

## Related

* [Capture observations](https://docs.cogram.com/field/observations.md): pinning findings to drawings on site.
* [Working offline](https://docs.cogram.com/field/working-offline.md): what else works without signal.
* [Drawing disciplines](https://docs.cogram.com/field/drawing-disciplines.md): the discipline list admins manage, used for filtering and automatic classification.
* [Project roles](https://docs.cogram.com/projects/project-roles.md): what each role can do with drawings.


---

# 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.cogram.com/field/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.
