> 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/guides/drawings.md).

# Drawings

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](/guides/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, and [discipline](/administration/drawing-disciplines.md) automatically. Check the results in the list and fix anything in place: click a drawing's **Discipline** cell to change it, or use the **Edit** action for the rest.

Uploading the same drawing number again creates a new revision, so the current sheet stays on top and older revisions remain available.

### 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](/administration/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](/guides/observations.md).

## Related

* [Capture Observations](/guides/observations.md): pinning findings to drawings on site.
* [Working Offline](/guides/working-offline.md): what else works without signal.
* [Drawing Disciplines](/administration/drawing-disciplines.md): the discipline list admins manage, used for filtering and automatic classification.
* [Project Roles](/administration/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 dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter:

```
GET https://docs.cogram.com/guides/drawings.md?ask=<question>&goal=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

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.
