# Revisions and redlines

> Compare drawing files, extract markups with Analyze Redlines, and work Revision Items to done in BuildX Studio, per submittal or across all jobs.

Source: https://docs.buildx.pro/docs/studio/revisions/

Redline review happens on a submittal's page in BuildX Studio (open a project, then a submittal). The all-jobs list lives at studio.mybuildx.com/revisions. Everyone on the job can use it.

## What you can do

- Preview any drawing file and compare two files with **Compare with**, in **Side by side** or **A/B toggle** layout.
- Run **Analyze Redlines** to have AI pull the markups into **Revision Items**.
- Assign each item, open its sheet, and check it off.
- Track progress in **Status Overview** and on the **Revisions** page, and **Export CSV**.

## Compare two drawing files

1. Open the submittal. Under **Drawing Files**, click the eye icon (**Preview**) on a file. The **Drawing Preview** opens.
2. Above the viewer, the **Revision:** buttons switch which file you're viewing.
3. In **Compare with**, pick another file. **Single view** turns comparison off.
4. Choose **Side by side** (A and B next to each other) or **A/B toggle** (flip between them with the A and B buttons).
5. Click **Exit compare** when you're done.

Comparison is visual: you look at both files. Studio doesn't compute a pixel difference.

## Pull markups with Analyze Redlines

> If AI analysis is unavailable or busy, the card shows the reason and offers **Run Again**. Nothing is saved from a failed run.

1. Upload the marked-up PDF to the submittal (**Upload Files**).
2. In the **Redline review** card, click **Analyze Redlines**. The steps show **Scanning Documents**, **Detecting Redlines**, **Extracting Items**, and **Prioritizing Tasks**.
3. When it finishes, each markup becomes a revision item with a description, sheet reference, location, priority, and an **AI** tag with a confidence percent.
4. Check every item against the sheet before you hand it off. Click **Sheet: ...** on an item to open that sheet in the preview with the item highlighted.

**Run Again** resets the card; click **Analyze Redlines** to run it again (for example after uploading a new markup set). Each run adds its items to the list.

## Work the Revision Items

- Items are grouped by category with a count of findings.
- Priority shows as a badge: **Critical** (high), **Review** (medium), or **Skim** (low).
- Click the assignee button (**Assign**) to pick someone on the job team, or **Unassign**.
- Check the box to mark an item done. Uncheck it to reopen it.
- **Status Overview** on the right shows **Completed**, **Pending**, and **Progress** %.

## Revisions across all jobs

The **Revisions** page ("Punch lists, all jobs") lists every revision item you can see:

- Counts: **Total Items**, **To Do**, **In Progress**, **Completed**.
- Filters: search, **Assigned to me** / **All**, status (**To Do**, **In Progress**, **Done**), and priority (**High**, **Medium**, **Low**).
- Each item links to its project, its submittal, and its sheet. Check the box to mark it done.
- **Export CSV** downloads the filtered list (description, sheet, location, priority, status, project, submittal).

**Tasks** in the sidebar opens the same page filtered to **To Do**. The project page's **Revision Log** tab shows the items for one job.

## Good to know

- Each run reads up to four pages in total, starting with the newest revision's pages in order. Put the marked-up sheets you care about first.
- Revision items come only from Analyze Redlines. You can't type one in by hand yet, and you can't edit an item's text or priority.
- The checkbox switches between To Do and Done. There is no control to set **In Progress**.
- Use **Upload Files → New revision** to upload the next numbered drawing set. To add sheets to the current set, choose the current-revision option instead. Uploading a new revision updates the submittal's revision number; the original files remain available for comparison.
- The **Comments** card on a submittal is a placeholder; Studio doesn't support comments yet.
- The robot button in the preview opens the **Drawing Assistant**. See [Ask Documents](https://docs.buildx.pro/docs/studio/ask-documents.md).

## Related

- [Projects and submittals](https://docs.buildx.pro/docs/studio/projects-submittals.md)
- [Schedule and crews](https://docs.buildx.pro/docs/studio/schedule-crews.md)
- [Ask Documents](https://docs.buildx.pro/docs/studio/ask-documents.md)