Ask how SubPro runs a submittal from the spec book to closeout, what the app does, or how to get started.
SubPro desktop app · user guide
From spec book to sent submittal, step by step
SubPro reads your project's spec book, builds the submittal log, and helps you put together, send and track every submittal. I wrote this guide to walk you through the main screens in the order you'll run into them on a real project.
Chapter 1Before you start
Take a few minutes and read this part first. SubPro turns the spec book into a submittal log you can check, and then carries each submittal through review and closeout.
What SubPro does
- Reads the spec book. You upload the PDF. SubPro finds every required submittal in every CSI division and lists them as rows, each linked to the page it came from. Every product the book names gets a row under the section it's named in, with the manufacturers the book lists for it. When a section names products but has no submittals article, SubPro still adds the rows and marks them Detailed review required so you confirm what's owed.
- Builds the log. Rows carry the spec section, the submittal type, the specified manufacturers and products, and a confidence score.
- Assembles the submittal. For any row, SubPro prints a transmittal cover on your letterhead, merges your cut sheets and any manufacturer documents it found, and gives you one PDF.
- Sends and tracks. Email the PDF from inside SubPro, log the reviewer's response, and watch days out, resubmittals and closeout dates.
What you need
- A Windows 10 or 11 computer and the SubPro installer from your welcome email.
- Your SubPro API key. It starts with sk_live_ and is in the same email.
- The project's spec book as a PDF. Books of several hundred pages are normal.
- Your company's transmittal sheet or letterhead as a one page PDF. You set this up once.
Chapter 2Install and first run
The installer puts SubPro on your computer, and the first time you open it you'll go through a two step setup.
-
Run the installer and follow the three screens.
The file is named SubPro-Setup-1.0.0-pilot.exe. Accept the default folder. If your computer is missing a Microsoft runtime, the installer adds it for you. Leave Run SubPro checked on the last screen.
-
Read the welcome screen and click Continue.
The welcome screen- 1Continue to the next step
-
Paste your API key and click Continue.
The button stays gray until the key has the right shape. Paste the whole key, including the sk_live_ start.
Enter your API key- 1Paste the key here
- 2Continue turns orange once the key looks right
-
Wait for the connection test.
SubPro checks the key against the SubPro service. A green check means you're in. If you see Could not connect, click Back to API key, paste the key again, and check that the computer is online.
The connection test, here shown with a bad key- 1Go back and fix the key
Chapter 3Find your way around
Two things get you around the whole app: the slim bar across the top, and the left rail that lists the pages of the open project.

- 1SubPro logo. Click it to go home to All Projects
- 2Search everything (also Ctrl+K)
- 3Chat about the spec book or the log (also Ctrl+J)
- 4Settings
The left rail
Once a project is open, its pages sit in a rail down the left side, in three groups. The project name sits at the top of the rail, and the page you are on is highlighted. Upload, Export and Lead times live on the pages that use them, so the top bar stays short.

- 1The project menu. Switch projects, open Project setup, parties and the project record
- 2Work: the pages you use every day
- 3Sources: the documents the log is built from
- 4Records: what the project owes at the end and what changed
- 5The Review count: rows waiting on somebody
- 6Hide labels folds the rail to icons
| Page | What it is for |
|---|---|
| Submittal log | The log. One row per required submittal, grouped by CSI division. Add submittal and Export sit on its header. |
| Review | Everything that has been sent. Days out, responses, returned copies. The count beside it shows the rows waiting on someone. |
| Schedule | Submit by and approval by dates worked back from the construction start, and the lead times table. |
| Spec book | The spec books on file for the project and any revisions. Upload sits here. |
| Drawings | Every schedule read from the drawing set, grouped by division, when your account has it turned on. See Chapter 21. |
| Closeout | O&M manuals, warranties, training and other closeout items with their due dates. |
| Modifications | ASIs, addenda and bulletins, and the rows they touch. |
On a narrow window the rail folds to icons by itself. Click Hide labels to fold it yourself, and Show labels to open it again. Hold the pointer over an icon to see the page name.

The project menu
Click the project name at the top of the rail to switch projects or reach the project menus.

- 1The current project. Click to open the menu
- 2Recent projects. Click one to switch
- 3Back to All Projects
- 4Start a new project
- 5Project parties (architect, owner, suppliers)
- 6Project record (contract number, award date, retention)
- 7Project setup: the checklist of what the project needs. See chapter 5
Light or dark
SubPro follows your Windows theme. To choose for yourself, open Settings and pick Light, Dark or System. Every screen in this guide is shown in light mode, except the two dark mode examples below.

- 1Light, Dark or System

Chapter 4All Projects, the home screen
This is where SubPro opens. Each row is a project and each column counts the submittals in that state, so you can see where the work is before you open anything.

- 1Start a new project
- 2Totals across your active projects. Click a card to filter the list
- 3Search projects by name or number
- 4Filters: all, has overdue, has unreviewed, show archived
- 5Click a row to open the project
- 6Row menu: archive or delete
Reading the counts
| Column | Meaning |
|---|---|
| Draft | Extracted or added, not yet sent. |
| Pending | Ready to send. Someone marked it ready but it has not gone out. |
| Submitted | Sent to the reviewer, no response yet. |
| Review | The reviewer confirmed receipt and is reviewing. |
| Revise | Returned revise and resubmit. |
| Rejected | Returned rejected. |
| Approved | Approved, or approved as noted. |
| Overdue | Rows past their due date that are still open. |
Archive a project
-
Click the three dots at the right end of the project's row.
The row menu- 1The row menu button
- 2Archive hides the project. Delete removes it for good and asks you to confirm
-
Choose Archive.
The project leaves the list and the totals. Turn on Show archived to see it again and bring it back. An undo message appears at the bottom of the screen for a few seconds.
Chapter 5Create a project
A project holds one spec book, its log, its parties and its dates. You'll need to create one before you upload anything.
-
Click + New Project on All Projects, or pick New Project in the project menu.
-
Fill in the name and number, then click Create project.
The name and number are required. The number becomes the prefix of every submittal number, so keep it short. Everything else can be added later from the project record or Project setup.
The New Project form- 1Back to All Projects without saving
- 2Project name and project number (required)
- 3A short description
- 4Owner or client, and the site location
- 5Start date and construction start date. The schedule works back from the construction start
- 6Create the project
-
Add the people you send to: open the project menu and choose Project parties.
Parties fill the To line of every transmittal and the email form. Tick default recipient on the person who reviews your submittals, usually the architect.
Project parties- 1Default recipient. This person is filled in on every transmittal
- 2Edit a party
- 3Remove a party
- 4Add a party: name, company, role, email and phone
-
Record the contract details: open the project menu and choose Project record.
Project record- 1Contract number, printed on transmittals
- 2Award date
- 3Keep the record until this date
- 4Set retention to three years from today
- 5Export the project record as a file
- 6Save
-
Check what is still missing: open the project menu and choose Project setup.
Project setup is a checklist of what a submittal package needs: the spec book, the parties with a default recipient, your transmittal template and the project dates. Each line says what is on file, with a button that takes you where to fix it. Under When you need them sit the things only some projects use: the Procore link, a drawing set and the closeout milestones. When the four required lines are done, the top line reads Ready to send.
Project setup- 1Ready to send, or how many of the four required items are in place
- 2The required items: spec book, parties, transmittal template and project dates
- 3An item that is not done yet, with the button that takes you there
- 4When you need them: Procore, a drawing set and the closeout milestones
Chapter 6Upload a spec book
One upload builds the whole log. A 500 page book takes a few minutes, and you can keep working while it runs.
-
Open the project, go to the Spec book page in the rail, click Upload, and choose New spec book.
Upload opens a menu with New spec book and Revised spec book (addendum). Choosing New spec book opens a file window. Pick the spec book PDF. SubPro accepts scanned books too and reads the scanned pages with OCR. On a new project the empty log offers Upload spec book as well.
Upload on the Spec book page- 1Upload
- 2New spec book: the first book for the project
- 3Revised spec book (addendum): a revision of a book already on file. See chapter 17
-
Watch the progress bar at the top of the log.
The bar shows the upload first, then the reading. The job keeps running in the SubPro service even if you close the app. When you come back, the log fills in on its own.
-
Look at the Spec book page to see the books on file.
The Spec book page- 1Spec book in the rail
- 2Filename, pages, upload date, status and the number of rows it produced
- 3A book on file. Its status turns Completed when the log is ready
- 4Upload a revised book later. See chapter 17
Chapter 7The submittal log
This is where you'll spend most of your time. Every row is one required submittal, in CSI order, with its status on the right.

- 1The project menu
- 2The left rail
- 3Quick filters with live counts
- 4Search by description, manufacturer or product
- 5Column headers. Click one to sort, click again to flip
- 6Division header. Click to collapse or expand a division
- 7Select rows to combine them
- 8Status chip
- 9Build this row's submittal. See chapter 12
The columns
| Column | What it shows |
|---|---|
| # | The submittal number. SubPro shows it as section, ordinal and revision, for example 03 30 00-031.00. The stored number is MG-2026-04-031. |
| Spec | The CSI section the requirement came from. |
| Type | Product data, shop drawings, samples, certificates, test reports, closeout, and so on. |
| Class | Action, informational, or closeout. Action submittals need an approval. Informational ones are for record only. |
| Tags and Qty | Equipment tags and quantities read from a drawing set. These columns show only when a row in the project has them. |
| Description | The requirement, in the spec book's own words. |
| Flags | Chips that ask for a second look: low confidence, possible duplicate, no page reference. |
| Status | Where the row is in the workflow. See the chart below. |
The page header
The header above the log names the page and holds the two things you do to the whole log: Add submittal for a row the spec book did not produce, and Export.

- 1The page title and what is on it
- 2Add submittal: add a row by hand
- 3Export the log to CSV or Excel. See chapter 18
The quick filters
- All shows every row.
- Draft shows rows not yet sent.
- Needs check shows rows nobody has reviewed yet. Work this list down after an upload.
- Approved shows what is done.
- Informational shows record only rows.
- Our court shows rows waiting on you: drafts you owe, returns to resubmit.
How a row moves
| Status | Meaning | Who has it |
|---|---|---|
| Draft | Extracted from the book or added by hand. | You |
| Ready to send | Checked and ready. | You |
| Submitted | Sent. The clock starts. | Reviewer |
| Under review | Reviewer confirmed receipt. | Reviewer |
| Approved / Approved as noted | Done. Approved as noted means small corrections without a resubmittal. | Closed |
| Revise & resubmit | Fix and send again. The revision number goes up. | You |
| Rejected | Not accepted. Usually a different product is needed. | You |
Combine rows into one submittal
Spec books often list several lines that you'd send as one package, like product data and installation instructions for the same product. Combine them so the log matches what you actually send.
-
Tick the checkbox on two or more rows.
Selecting rows- 1Tick the rows
- 2The count of selected rows
- 3Clear the selection
- 4Combine into one submittal
-
Click Combine into one submittal and choose the parent.
Either one of the selected rows becomes the parent, or you write a new umbrella description. The other rows become children with dotted numbers such as 044.1. Rows already sent keep their history.
Combine into one submittal- 1Use one of the selected rows as the parent
- 2Pick which row leads
- 3Or write a new umbrella description
- 4Confirm you understand that sent numbers may change
- 5Combine
Chapter 8Work a single submittal
Click any row and it opens right there in the log. Everything you can do to one submittal is in this panel.

- 1The open row
- 2Type, specified manufacturers, product, and the source page with its confidence score
- 3Ball in court: who the row is waiting on
- 4Transmittal number and review cycle
- 5The exact text from the spec book
- 7Documents for this submittal: the manufacturer documents this row needs. See chapter 10
- 8Create Submittal: build the transmittal and PDF
- 9Edit the row
- 10Open the spec book at the source page
- 11More: remove, copy the number, void
- 12Link this row to another row
- 13Close the panel
Edit a row
-
Click Edit in the panel.
Change anything the extraction got wrong, choose the manufacturer you're actually submitting, and record drawing references or a deviation. The less used fields sit in folded groups (Drawings and references, Parties, Delivery, As built, Closeout due), and a group opens by itself when it already holds something. Only the fields you change get saved.
Edit submittal- 1Spec section and title
- 2Description
- 3All manufacturers named in the spec book, comma separated
- 4The manufacturer you are submitting
- 5Products
- 6Tick if your product deviates from the spec book, then describe the deviation
- 7Drawings and references: drawing reference and other references (RFI, ASI, CO)
- 8Parties: who you received it from and who is copied
- 9Save
Mark a row as submitted
Use this when a submittal went out some other way, like by hand or from another system, and you want the log to show it.
-
Open a draft row and click Mark as submitted.
A draft row- 1Ball in court shows Our court on a draft
- 2Mark as submitted
-
Set the date, add a note if you want, and confirm.
Mark as submitted- 1The date it went out. This becomes the Submitted entry in the history
- 2An optional note
- 3Confirm
The More menu

- 1The More menu. Not a submittal removes the row. Copy submittal # copies the number. Mark not applicable keeps the row but takes it off the list of work. Void withdraws a row and keeps its number unused
-
To remove a row the extraction should not have made, choose Not a submittal.
Tell SubPro why, because the reason helps it do better on the next extraction. The row comes out of the log, the exports and the chat.
Not a submittal- 1Why it is not a submittal (optional)
- 2Remove from log
Link two rows
-
Click + Link submittal at the bottom of the panel, choose the link type, and pick the other row.
Related is a plain cross reference. Supersedes says this row replaces the other one. Depends on says the other row must be approved first.
Link submittal- 1Link type
- 2Pick the other row from the list
- 3Close
Chapter 9Check the source page
When somebody asks "where does the spec say that?", you're one click from the answer.
-
Open a row and click Open source PDF.
The spec book the row came from opens to the page it cites. On a project with an addendum, a row from the original book opens the original book. The band at the top repeats the exact sentence the row came from, and the sentence is highlighted on the page.
The spec book viewer- 1Close the viewer
- 2The book you are reading
- 3The source text for this submittal
- 4Page back and forward. The counter shows the page and the total
Chapter 10Manufacturer documents
Each row needs one kind of manufacturer document: product data, a warranty, a safety data sheet, a shop drawing, a sustainability document and so on. For rows with a known manufacturer, SubPro looks in its manufacturer catalog for that document. That is the Documents for this submittal section of the panel.
-
Check the document kind.
SubPro decides the kind from the row's own words and its type, so a warranty row asks for a warranty and a product data row asks for product data. A row that needs no manufacturer document, like a sample or a field report, says so. If SubPro picked the wrong kind, change it in Document kind in the panel or in Edit.
Documents for this submittal- 1Document kind. Decide from the row, or pick one of the kinds
- 2The manufacturer you are submitting
- 3The product. In the panel this second picker is labeled by the kind, for example Warranty
-
Pick the manufacturer, then the product or document, in the Documents for this submittal section.
The manufacturer list comes from the spec book. The second picker lists only the manufacturer's documents of the row's kind, so a warranty row shows warranties. SubPro remembers your choices for the whole project.
-
Read the status chip and click Refresh deliverables if it is still searching.
| Chip | Meaning |
|---|---|
| Ready | The documents are on file and go into the package automatically. |
| Partial | Some documents are ready, some are missing. The missing kinds are listed. |
| Researching | The catalog is still locating the document. Check back later. |
| Not found | Nothing was found. Attach your own cut sheets when you build the package. |
| Not checked | No manufacturer chosen yet. |
Chapter 11Set up your transmittal
SubPro prints every transmittal on your company's own sheet. You only set the sheet up once per project, and it takes about two minutes.
-
Click Create Submittal on any row. The first time, SubPro asks for a template.
No template yet- 1Set up transmittal template
-
Click Choose File and pick your transmittal sheet.
Use a one page PDF of your blank transmittal form or letterhead. The labels on the form (Project, Date, To, Description and so on) are what SubPro looks for.
The template page- 1Back to the project
- 2Choose the PDF
-
Check the mapping SubPro suggests, fix any field that is wrong, and click Save template.
The green boxes on the preview are the regions SubPro found. The list on the right shows which SubPro field fills each one. If a box got the wrong field, change its dropdown. Leave a box Unmapped to keep it blank.
Confirm field mapping- 1A region SubPro found on your sheet
- 2One dropdown per region, in page order
- 3Unmapped means the box stays blank
- 4Save template
Chapter 12Build and send a submittal
One submittal is one row. It's the transmittal cover, your cut sheets and any manufacturer documents, merged into one PDF with continuous page numbers.
-
Open the row and click Create Submittal.
Create Submittal- 1Attach cut sheets. Pick one or more PDFs
- 2Save package renders the transmittal and merges everything
-
Attach your cut sheets, then click Save package.
The transmittal appears in the preview with the project, date, section, recipient, description and manufacturer already filled from the row. The page count under the preview includes your attachments. Each attached cut sheet is listed above the preview with a cross to remove it. The file is saved under Documents\SubPro\projects\<project>\submittals.
The rendered submittal- 1Save package again after changing attachments
- 2The preview. Scroll to read every page
- 3Total pages
- 4Mark up the pages. See chapter 13
- 5Save a copy somewhere else
- 6Open the project folder
- 7Email the submittal
-
Click Email…, check the form, tick the box if there is a warning, and click Send.
The To line is filled from the default recipient. Put your own address in Your email so you get the replies and a copy. The mail goes out through your company's Microsoft 365 mailbox, so it shows up in your Sent folder too. The row moves to Submitted and the review clock starts.
The email form- 1To, filled from the project parties
- 2CC
- 3Your email, for replies and a copy
- 4The message. Edit it freely
- 5Warnings before sending. Tick the box to send anyway. The choice is recorded in the audit log
- 6Send
Chapter 13Mark up the pages
You can circle the product you're submitting, cloud a dimension or stamp the cover. The markup editor works on the finished submittal before you send it.
-
Click Mark up under the preview.
The markup editor- 1Close without saving
- 2Page back and forward
- 3Zoom out and in
- 4Undo and redo
- 5Cancel, or Done to save the marks into the PDF
- 6Page thumbnails. Click one to jump
- 7Tools: select, text, rectangle, ellipse, line, arrow, revision cloud, pen, highlight, company stamp, image stamp
- 8Delete the selected mark
- 9Color
- 10Stroke width
- 11Text size. The keyboard shortcut for every tool is listed below the panel
-
Pick a tool, draw on the page, and click Done.
Press V to go back to Select, Delete to remove a mark, Ctrl+Z to undo. Your marks get burned into the saved PDF when you click Done, and Cancel throws them away.
Chapter 14Track reviews and responses
The Review page shows every submittal that's gone out, how many days it's been out and what came back. The count beside Review in the rail shows the rows waiting on somebody.

- 1Review in the rail and its waiting count
- 2Number, cycle, title, spec section, sent date, days out, status, response date and returned copies
- 3Open the status history of a row
- 4Status chip, with the reviewer's own stamp words beneath it
- 5Attach the reviewer's returned copy with the paperclip. Each copy shows as a link, Copy 1, Copy 2
Log the reviewer's response
-
Find the row, click Respond, and choose the response that matches the reviewer's stamp.
Every response sits in the one Respond menu at the end of the row. Rows still marked Submitted also offer Mark under review at the top of the menu, for when the reviewer confirms receipt. Sent and Days out follow the cycle the row is on, so a resubmittal counts from the day it went out again.
The Respond menu- 1Respond
- 3The responses: Approve, Approve as Noted, Revise & Resubmit, Reject, Not Reviewed, Acknowledge Receipt
The responses in the Respond menu- 1Open the history
- 2Approve
- 3Approve as Noted
- 4Revise & Resubmit
- 5Reject
- 6Not Reviewed, for a return without action
- 7Acknowledge Receipt, for record only rows
-
Set the response date, add the reviewer's notes, and confirm.
Some moves need a reason, and the confirm button won't work until you give one. Attach the returned copy in the dialog, or afterward with the paperclip in the Returned column, so the stamped page stays with the row. The Response column shows the reviewer's date from the dialog.
Recording an approval- 1The date on the reviewer's return
- 2Notes from the return
- 3Confirm
Chapter 15Schedule and lead times
SubPro works backward from the construction start. It takes the date you need it on site, subtracts the lead time and the review time, and that gives you the date you have to submit by.
-
Open the Schedule page, check the two dates, and click Auto-schedule.
Every row gets three dates: submit by, approval by and need on site. Rows that are already late or at risk are flagged, and Risk first sorts them to the top. Once the dates are set they fold to one line; click Edit to change them.
The Schedule page- 1Project start and construction start, on one line
- 2Edit the dates
- 3Auto-schedule every row
- 4Export an Excel Gantt chart
- 5Phases: split the job into phases with their own start dates
- 6Risk first sorting
- 7Filters: late, critical, at risk, watch
- 8Lead time in weeks
- 9Risk flags
-
Adjust lead times where you know better: edit a row's lead time, or click Lead times on the Schedule page to open the table.
The table holds a default lead time for each product category, and SubPro starts it off with typical values. If you edit a category, every row in that category picks up the change on the next Auto-schedule. The table is shared by every project. Click Hide lead times to close it.
Lead times on the Schedule page- 1Hide lead times closes the panel
- 2The lead time categories: name, CSI prefixes, weeks, source and the date it changed
Lead times- 1Hide lead times
- 2Search categories
- 3Edit a category's weeks
Chapter 16Closeout and warranties
Closeout items (O&M manuals, training, warranties, spare parts) are due against a milestone instead of the construction start. The Closeout page keeps them all in one place.
-
Open the Closeout page and set the four milestone dates.
Once they are set, the milestones fold to one line. Click Edit to change them. The closeout log and the as built table both export from the one Export button.
The Closeout page- 1Substantial completion, beneficial occupancy, final completion, certificate of occupancy
- 2Edit the milestones
- 3Export the closeout log or the as built table
- 5Build the closeout binder: one PDF of every closeout document
- 6How many rows are closeout items
- 7Each row is due relative to a milestone
-
Scroll down to Warranties. Click Seed from register to create one warranty for each row in the log that requires a warranty, or Add warranty for one at a time.
Warranties- 1Seed warranties from the log rows that require one
- 2Add a warranty by hand
- 3Export the warranty schedule
- 4Edit a warranty: item, manufacturer, model, term, start basis
- 5Remove a warranty
Chapter 17Modifications and revisions
When the design team issues an ASI, addendum or bulletin, record it here. SubPro reads the reissued section, shows you what changed and lets you accept the changes one row at a time.

- 1Export the modification log
- 2Add a modification
- 3Expand to see the rows it touches
- 4Kind and number, title, issued date, sections, rows pending, status and attached PDF
- 5Rows still waiting on a decision, out of rows touched
- 6Open until every touched row is decided
- 7Run section diff, available once a PDF is attached
- 8Edit
- 9Remove
-
Click Add modification and fill in what the design team sent.
Add modification- 1Number, for example 03
- 2Title
- 3Issued and received dates
- 4Affected sections or divisions, comma separated
- 5What changed
- 6Attach the PDF
- 7Add
-
Expand the modification and decide each touched row.
Mark a row No impact if the change doesn't affect that submittal. Rows with a real change need a decision after the diff runs.
Rows touched by the modification- 1Expand or collapse
- 2No impact clears the row
- 3Run section diff once a PDF is attached
-
With the PDF attached, click Run section diff, then review the changes on the Spec book page.
SubPro reads the reissued section and lists rows added, modified and removed. Accept or reject each change, then click Apply. Nothing is saved until you apply. Rows already approved are never changed silently, and a row that replaces an old one records a Supersedes link.
Chapter 18Chat, search and export
Ask the chat
The chat answers questions about the open project in plain language and tells you the page or the row the answer came from. You can switch the scope between the spec book and the submittal log.

- 1Close
- 2Scope: the spec book, or the submittal log
- 3Start a new conversation
- 4Type a question
- 5Send
Questions that work well: "Which sections require samples?", "What is still unapproved in Division 8?", "Where does the book name Sherwin Williams?".
Search everything
Press Ctrl+K anywhere, or click the magnifier in the top bar. Results cover projects and submittals. Press Enter on a result to jump to it.

- 1Type what you are looking for
- 2Results update as you type
Export the log
Click Export on the Submittal log header and choose CSV or Excel. The file is sorted by division and section and carries status, source page, manufacturer and product columns, flags and review states. It opens in Excel and anything that reads an Excel or CSV file. To put submittals into Procore, use the Procore integration in chapter 20.

- 1Export on the log header
- 2CSV or Excel
Chapter 19Settings
Open Settings from the gear in the top bar. Your connections come first, then how the app looks, and Show advanced opens the rest.

- 1Back to where you were
- 2Light, dark or follow Windows
- 3Company name and accent color, used on screens and stamps
- 4Upload your logo
- 5Save branding
Below branding sit the stamp line and default initials for the company stamp, and Show advanced.
Advanced

- 1Hide advanced
- 8Where SubPro sends spec books for reading. Leave it as set
- 9Your API key
- 10Reveal the key to check it
You connect your Microsoft 365 mailbox once. SubPro sends from that mailbox and never stores your password. Your IT admin may need to approve the connection the first time.
Procore
Connect your own Procore account here, then link projects, pull the spec book and send submittals from the project. The SubPro app must be installed on your Procore company first. See chapter 20.
AI service connection
Under Show advanced: where SubPro sends spec books for reading, and your API key, with Test connection and Save changes. Leave the address as it was set for you.
Extraction behavior
Shows the reading options your account has: OCR for scanned pages, sub item expansion, second pass enrichment. These are set on the server.
Local paths
Where uploads and rendered files live on this computer, and the upload size limit.
Chapter 20Procore
SubPro creates the submittals and Procore manages them. SubPro reads the spec book from your Procore project and writes items into the Submittals tool with the submittal package attached. It never edits or deletes anything in Procore, and it creates every item with Procore's email notices turned off.
Before you start
- A Procore admin installs the SubPro app on your Procore company once, from Company Tools, Admin, App Management. Until that is done, linking a project stops with the message Ask your Procore admin to install SubPro for your company name.
- You sign in with your own Procore account. SubPro sees only the companies, projects and tools your Procore permissions already let you see.
- SubPro sends the submittal package you build in SubPro (chapter 12). A row without one is held back until you build it.
Connect your Procore account
-
Open Settings, scroll to Connections, and click Connect Procore.
Your browser opens on Procore's own sign in page. SubPro never sees your Procore password.
Connections in Settings, before you connect- 1Connections: your mailbox and Procore
- 2Connect Procore
-
Sign in to Procore with your own account.
The first time, Procore asks whether SubPro may use your account; allow it. Procore skips that question once you have allowed SubPro before. When the browser tab reads "SubPro is connected to Procore. You can close this tab.", close it and go back to SubPro.
Procore's sign in page- 1Your Procore email
- 2Continue, then your password
-
Check the Procore card in Settings.
It now shows the Procore login you signed in with and whether it is the sandbox or production. The sign in is kept in this computer's encrypted store, so you connect once per machine.
Connected- 1Connected
- 2The Procore login in use
- 3sandbox or production
- 4Disconnect
Start a new project from Procore
If the project is already in Procore, you don't have to type it in. SubPro fills in the project from Procore, links it and pulls the spec book in one go.
-
Click + New Project on All Projects, then click Import from Procore at the top of the form.
The button only shows when this computer is connected to Procore. If you don't see it, connect from Settings first.
-
Pick the Company and the Procore project, then click Use this project.
The name, number, description, location and start date fill in from Procore. You can still change any of them. A green chip reads From Procore: and the project name, and Pick another lets you choose a different project. Cancel import takes you back to a blank form.
-
Check the project number. It starts with P.
SubPro puts a P in front of Procore's project number, so Procore's 1234 becomes P1234. When the Procore project has no number, SubPro uses P and Procore's project id. The P marks a project that came from Procore, so it never runs into a number you typed yourself. A number that already starts with P is left as it is.
-
Click Create and link to Procore.
SubPro creates the project, links it to the Procore project, starts pulling the spec book and opens the Spec book page, where you can watch it read. If the link doesn't go through, the project is still created and SubPro tells you; link it from the Spec book page as shown below. If the pull doesn't start, SubPro says why, and you can click Pull spec book on the Spec book page.

- 1The project number starts with P
- 2The From Procore chip, with Pick another beside it
- 3Create and link to Procore
Link a project
For a project you already have in SubPro, link it from the Spec book page.
-
Open the project, go to the Spec book page, and click Link to Procore.
If the page reads "Connect Procore in Settings to link this project." instead, the Procore sign in is missing on this computer. Connect it from Settings first.
A project that is not linked yet- 1Spec book in the rail
- 2Link to Procore
-
Pick the Company and the Procore project, then click Link.
The lists hold only what your Procore account can open. When your login belongs to one company, SubPro fills in the company for you. One SubPro project links to one Procore project.
Choose the Procore project- 1Company
- 2Procore project
- 3Link
- 4Cancel
-
Check the linked panel.
The green Procore chip and the Procore project name confirm the link. Four actions sit under it.
A linked project- 1The linked Procore project
- 2Unlink
- 3Pull spec book, from Procore's Specifications tool
- 4Pull again as revision, when Procore's spec book changes
- 5Pull from Documents, for a spec book kept as one PDF
- 6Refresh status, reads submittal status from Procore now
- 7How the spec book compares with Procore's section list
Pull the spec book
-
Click Pull spec book.
SubPro reads every section in Procore's Specifications tool, downloads the current revision of each one, puts them together in division and section order as one spec book, and reads it the same way it reads an upload (chapter 6). The panel says how many sections it is pulling. The download runs quietly for about a minute before the progress bar appears; leave it running.
-
If the GC keeps the spec book as one PDF, click Pull from Documents and pick the file.
The list shows every PDF in the project's Documents tool by its folder path. Click one and SubPro pulls that file and reads it.
-
When the reading finishes, the spec book appears in the list and the submittal log fills in.
The list shows the page count and how many submittals SubPro found, as for any upload.
A spec book pulled from Procore, read and ready- 1Status last checked
- 2The pulled spec book, its pages and the submittals found
The coverage check
Once SubPro has compared a pulled book with Procore's own section list, the line under the actions becomes a coverage check. It starts "Coverage:" with the section count on each side, then reads either The spec book and Procore agree on every section. or lists the sections found on one side only, under "In the spec book but not in Procore:" and "In Procore but not in the spec book:". A section the book has and Procore lacks is worth a word with the GC. A section Procore lists that the book lacks means the pull is incomplete or the book is out of date. Until that comparison exists, the line reads "No section map on record yet".
When Procore's spec book changes
Click Pull again as revision. SubPro first shows what a new pull would change: sections new in Procore, sections no longer in Procore, and sections revised, or Nothing changed since the last pull. Click Create the revision to pull the current book as a revision of the one you have, or Cancel to leave it. The revision is compared with your log the same way as Upload revision (chapter 17).
Send submittals to Procore
-
On the Submittal log, tick the rows to send and click Send to Procore.
The number on the button counts the ticked rows that are not in Procore yet. A linked project's log has a Procore column; rows not sent read "not sent".
Send from the log- 1Filters. Needs revision joins them when Procore returns a row for revision
- 2How many rows are ticked
- 3Send to Procore
- 4Refresh reads submittal status from Procore now
- 5The Procore column
-
Read the check SubPro runs before anything is sent.
The dialog lists each submittal with its number, its responsible contractor, its submittal type and a verdict, ready or blocked. The contractor list is the project's own vendor list from Procore's Directory. Change the contractor on a row and SubPro checks that row again.
The check before sending- 1The responsible contractor SubPro picked for you
- 2SubPro's submittal number
- 3Responsible contractor, from Procore's Directory
- 4The verdict: ready or blocked
- 5The Procore submittal type
- 6Send the ready rows
-
Clear anything that blocks a row.
A blocked row says why, in these words:
The row says What to do Spec section ... is not in Procore's Specifications tool for this project. SubPro never creates sections. Ask the GC to add it in Procore, or correct the row's section in SubPro. Number ... already exists in Procore. Click the Use button with the number Procore offers. SubPro renumbers the row and its transmittal cover, then checks it again. Procore has no submittal type named ... for this company. Change the row's type to one your Procore company uses. No responsible contractor: pick one from the project Directory list. Pick the contractor on the row. No submittal package for this row yet: build the submittal package first. Build the package (chapter 12), then send. This submittal is already in Procore. Use Send revision to send a new revision. See Revise and resubmit below. Procore did not answer the number check; a duplicate would be rejected at send. A warning, not a block. Tick the box on the row that reads Send, the number, and anyway, to send it as it is, or close and try again. -
Click Send 1 ready, then Done.
The number on the button counts the ready rows, and only those go. Each one becomes an item in Procore's Submittals tool with its submittal package attached, its verdict changes to Sent as and the Procore number, and its status in SubPro moves to Submitted. One failed row never stops the others; it shows Procore's reason and can be sent again. If a send comes back with "Procore cannot take this yet:", the reasons below it are in the same words as the table above.
After the send- 1Sent, with the number the item has in Procore
- 2Done closes the dialog and updates the log
What lands in Procore
In Procore, the Submittals tool lists the new item under its spec section with SubPro's number, the submittal type, the responsible contractor and the status Open. Open the item and the submittal package is in its attachments: the transmittal and the product documents behind it. Review happens in Procore's own workflow from there.

- 1Procore's test project line: this is the sandbox
- 2The item SubPro created, with SubPro's number
- 3The submittal type

- 4Status Open
- 5The responsible contractor picked in SubPro
Back in SubPro, the Procore column on a sent row shows Procore's status and response, and below them the ball in court and the date SubPro last checked. Hold the pointer over the cell to see the Procore number and revision. The cell turns red on a row Procore returned for revision.
Keep status current
SubPro reads submittal status from Procore when you open a linked project, every five minutes while it stays open, and when you come back to the SubPro window after working in Procore. To read it now, click Refresh on the Submittal log or Refresh status on the Spec book page. A manual refresh reports how many submittals it checked, how many need revision and how many moved in review. An automatic one stays quiet unless it moved a row, then says so. Reading status writes nothing to Procore.
When the reviewer answers in Procore, SubPro moves the row the way you would on the Review page (chapter 14), and the history names Procore as the one who moved it. A submitted row moves to Under review while Procore holds it, then to the verdict: Approved, Approved as noted, Revise & resubmit, Rejected, Receipt acknowledged or Not reviewed, dated with the response date Procore gives. SubPro never moves a row backwards. If a row already holds a verdict, it keeps it, and the Procore column shows what Procore says now.

- 1Review in the rail, with its count
- 2The status Procore's response set
- 3The response date from Procore
- 4Procore received the item, so the row moved to Under review
- 5Procore's response, Revise and Resubmit, with its date
- 6The revision sent, which starts the next cycle
Revise and resubmit
-
Find the rows Procore sent back.
When a row comes back Revise and Resubmit or Rejected, a Needs revision filter appears beside the other filters on the Submittal log, with its count. Click it to see those rows alone.
-
Fix the row, save its submittal package again (chapter 12), and click Send revision on the row.
Every row already in Procore carries Send revision beside Create Submittal. The dialog creates a new Procore submittal revision linked to the original, with the current submittal package attached. Click Send revision in the dialog. The new revision lands on the same Procore submittal, and the earlier revision stays as it was.
Unlink and disconnect
Unlink
On the Spec book page. Ends the project's link to Procore at once. The submittal log stays, and SubPro remembers which row went to which Procore item, so linking the same Procore project again picks up status and revisions where they were. Nothing changes in Procore.
Disconnect
In Settings. Deletes the Procore sign in from this computer's encrypted store and asks Procore to revoke it. Projects stay linked, but SubPro cannot read or send until you connect again.
Questions about Procore
What does SubPro write to Procore?
Only submittal items in the Submittals tool, each with its submittal package attached, and new revisions of those items. Nothing goes into Specifications, Documents, the Directory or company settings.
Why does the number look different in Procore?
SubPro keeps the full number with the section in front, such as 096623-PC-00010-031. Procore files the item under its spec section, and some Procore screens show the number without the section digits. It is the same submittal.
Can SubPro show every revision of one item?
SubPro keeps one Procore link per submittal, pointing at the latest revision sent. Procore keeps the whole chain on its side. The Review page keeps every cycle in SubPro.
Chapter 21Drawings
The drawings carry what the spec book leaves open: which fan, which door, which carpet, which card reader. Upload the drawing set and SubPro reads every schedule on it, in every division, and lists the rows under Drawings so you can approve them into the log. This page shows only when your account has it turned on.
-
Open Drawings under Sources and upload the drawing set as one PDF.
SubPro indexes every sheet, finds the schedule sheets and reads the tables on them. A set of fifty sheets takes a few minutes. The sheet list shows what it found, and the divisions appear on the left as the schedules are read.
-
Pick a division on the left.
Each division lists its schedules with a row count and the number of rows still to review. The tables on the right are one per schedule type: fans under HVAC, doors under Openings, finishes under Finishes, cameras under Safety and security. A division appears only when the set carries one of its schedules.
-
Read the rows the way the drawings read.
Equipment rows carry the tag, the make and the model as drawn, and the capacities the schedule gives. Doors, finishes and secured doors are listed by door and by room, the way a superintendent looks them up. The arrow beside a tag opens the detail.
-
Approve a row to write it to the submittal log.
An approved row lands on the log line that names its manufacturer in its spec section, with the tag added to the line and the quantity counted from the drawings. When no line names the make, the row lands on the section's own line and the discrepancy note says so, since that is a possible RFI. When two lines fit, SubPro asks you to pick. When the spec book has no line at all, SubPro adds one marked as coming from the drawings. Reject takes a row back off its line and never deletes the line.
-
Check Skipped and unread under the tables.
Every table on a schedule sheet is listed as read, skipped or unread with the reason, so nothing disappears quietly. Partition types, feeder schedules and pipe schedules are skipped by name because they carry no product. A table SubPro could not read is listed as unread with its header so you can see what it was.
-
Click Export CSV for the approved rows.
The export carries the division, schedule type, tag, make, model, the log line each row landed on and its quantity. It is the hand off a facilities partner takes for make and model recovery.
What each row is
| Row | What it is | What approving it does |
|---|---|---|
| Product | One tagged piece of equipment with a make and model: a fan, a pump, a light fixture, a camera, a sign, a bench, an elevator. | Lands on the line naming its make. The tag joins the line and the quantity counts the tags. |
| Door | One door from the door schedule, with its door type, frame type, material, size and hardware set. The door's and frame's make and model show when a door types or frame types table names them. | Lands on the door line its material chooses: hollow metal, wood, aluminum, coiling. The door number joins the line and the doors are counted. |
| Door hardware | The hardware on one door, from the set the door schedule assigns it: hinges, lockset, closer, stop, and any electric strike or card reader. | Each item lands on the 08 71 00 line naming its make, the door number as the tag. Security devices go to a Division 28 line first. A line's quantity is the sum over the doors on it. An item with no make, or a make two lines carry, stays blank. |
| Keys | The key sets, key numbers and core on one door, from the keying schedule. | Lands on the keying line under 08 71 00 with the door number as the tag. |
| Room | One room from the room finish schedule with the finish on each surface, resolved through the finish legend to a make, product and color. | Nothing. Finishes are approved from the legend. |
| Finish | One code from the finish legend or paint schedule. A carpet code stands for a make, a product and a color. | Lands on the line naming its make with the rooms as tags and no quantity. A room count is not a carpet quantity. |
| Secured door | One door from the access control door schedule with its reader, strike, contact, request to exit and camera, resolved through the device legend. | Lands on the access control line with the door number as the tag. |
| Plant | One key from the plant schedule with its botanical and common name, size and count. | Lands on the planting line. Kept for the record, never counted. |
The divisions SubPro reads
| Division | Schedules |
|---|---|
| 08 Openings | Door schedule, door types, frame types, door hardware schedule (as a grid or as hardware sets printed in prose), keying schedule (as a list or as a matrix), window, storefront, louver, access door, overhead door and skylight schedules. |
| 09 Finishes | Room finish schedule, finish legend, material legend, finish key, paint schedule. Partition types are listed as skipped. |
| 10 Specialties | Toilet accessories, signage, fire extinguishers, lockers, toilet partitions, wall protection. |
| 11, 12, 14 | Food service, appliances, laboratory and loading dock equipment; casework, furniture, window treatments; elevators, lifts, dumbwaiters. |
| 21, 22, 23 | Sprinkler heads, fire pumps, standpipes; plumbing fixtures, water heaters, pumps, mixing valves; every HVAC schedule from fans and air handlers to dampers, coils and heat pumps. |
| 26 Electrical | Light fixtures, panelboards (each panel schedule becomes one panelboard row from its header block), switchboards, transformers, generators, disconnects, transfer switches, lighting controls, surge protection, UPS, drives. Feeder, conduit and load schedules are listed as skipped. |
| 27 Communications | Telecommunications equipment, audio visual, paging and intercom, distributed antenna, nurse call, clocks. |
| 28 Safety and security | Cameras, access control, security device legends, access control door schedules, fire alarm devices, mass notification. |
| 32 Site | Site furnishings, fences and gates, site lighting, plant schedules, irrigation. Storm structures, pipe and utility schedules are listed as skipped. |
Chapter 22Keyboard shortcuts
| Keys | Where | What happens |
|---|---|---|
| Ctrl+K | Anywhere | Open search |
| Ctrl+J | Anywhere | Open or close the chat |
| Esc | Any dialog or drawer | Close it |
| Ctrl++ / Ctrl+- | Anywhere | Zoom the whole app in or out |
| V T R E L A C P H S I | Markup editor | Select, text, rectangle, ellipse, line, arrow, cloud, pen, highlight, company stamp, image stamp |
| Delete / Backspace | Markup editor | Delete the selected mark |
| Ctrl+Z / Ctrl+Shift+Z | Markup editor | Undo, redo |
| + / - | Markup editor | Zoom the page |
Chapter 23Troubleshooting
| What you see | What it means and what to do |
|---|---|
| The setup says the key is invalid | The key was mistyped or is not active. Paste it again from the welcome email. If it still fails, write to support and ask for a fresh key. |
| Could not connect on the last setup step | The computer cannot reach the SubPro service. Check the internet connection and any VPN, then click Back to API key and try again. |
| An upload sits in processing for a long time | Big books take longer. The job keeps running even if you close SubPro. If nothing has changed after an hour, close and reopen the project. The log syncs on its own when the job completes. |
| A section warning after processing | One section hit a reading limit and was retried. Spot check that section in the viewer. The warning exists so nothing is left out silently. |
| Blank manufacturer or product on many rows | The spec book did not name them, which is common in general sections. Rows that do name them are filled. Add the rest from Edit as you learn them. |
| Deliverables stuck on Researching | The catalog is still locating the document. Uncommon products take longer. Attach your own cut sheet and send. The submittal does not wait. |
| No PDF available for this submittal | The viewer's copy of the book lives on the computer where it was uploaded. Upload the book again on this computer to see it in the viewer. |
| Create Submittal asks for a template | This project has no transmittal sheet yet. Follow chapter 11. It takes two minutes and you do it once per project. |
| Email fails to send | The message names the failing step. Most often the Microsoft 365 mailbox permission changed. Ask your IT admin, or click Save As and send the PDF from your own mail client. |
| Send is gray with a warning box | Read the warning. Fix it, or tick "I have checked these" to send anyway. Your choice is recorded in the audit log. |
| A row I removed still shows in an old export | Exports are snapshots. Export again. Removed rows leave the log, the chat and every new export. |
| Days out shows a dash | The row has no Submitted entry in its history. Use Mark as submitted with the real date. |
Still stuck? Write to support@sub-pro-ai.com with the project name and a screenshot.
Chapter 24Questions people ask
Is the log a final answer?
No. It's a first pass, built for a person to check. Rows carry confidence scores and flags so you can spend your time on the ones SubPro is less sure about. Use the Needs check filter after every upload.
Where does my spec book go?
It goes to the SubPro service to be read, and the spec book you upload is deleted when processing finishes. SubPro keeps the rows it pulled out of the book. The viewer's copy stays on your computer only.
Can two people work the same project?
The log lives on one computer. If you need to share it, export to Excel or send the submittals to Procore (chapter 20). A shared workspace is on the roadmap.
How are submittal numbers assigned?
In CSI order, by the project number prefix. The screen shows section, ordinal and revision. Combining rows or applying a revision can renumber rows that were never sent. Sent numbers are protected and SubPro warns you before touching them.
What is a class?
Action submittals need the reviewer's approval. Informational ones are for record only and get no approval clock. Closeout items are due against a milestone rather than the construction start.
What counts against my allowance?
Each spec book read and each modification diff. Uploading the identical file again to the same project reuses the log and is not read again. Building, marking up and emailing submittals is free.
Can I change the transmittal after saving?
Yes. Change the row or the attachments and click Save package again, then Mark up if you need to. Each save replaces the file in the project folder.
Does SubPro send anything on its own?
SubPro never sends a submittal or an email on its own. A submittal goes out only when you click Send in the email form (chapter 12) or in the Send to Procore dialog (chapter 20), and every email send is recorded in the audit log with who sent it and any warning you overrode. Other data moves without a Send: a spec book goes to the SubPro service for reading when you upload it (chapter 6), and a project linked to Procore reads submittal status from Procore, which writes nothing there.
Chapter 25Glossary
- Spec book
- The project manual. The PDF of specifications you upload.
- CSI section
- The six digit MasterFormat number for a section, such as 03 30 00 Cast in Place Concrete. Divisions are the first two digits.
- Submittal
- One item the spec book requires you to submit for review: product data, shop drawings, samples, certificates, reports, manuals, warranties.
- Submittal log
- The full list of required submittals for a project, with status. Also called the register.
- Transmittal
- The cover sheet that goes on top of a submittal. SubPro prints it on your template.
- Submittal package
- The transmittal plus the cut sheets and manufacturer documents, merged into one PDF. One package is one submittal.
- Cut sheet
- A manufacturer's product data sheet.
- Basis of design
- The manufacturer and product the spec book names as the standard. Substitutions are measured against it.
- Deviation
- A submitted product that differs from the spec book. Must be described on the transmittal.
- Ball in court
- Who the row is waiting on: you, the reviewer, or closed.
- Cycle
- One send and return. A resubmittal starts cycle 2.
- Days out
- Days since the submittal was sent, while it is waiting on the reviewer.
- Lead time
- Weeks from approval to material on site, by product category.
- Deliverables
- The manufacturer documents a submittal needs. SubPro finds them in its catalog.
- Modification
- An ASI, addendum, bulletin or change order that alters the spec book after award.
- Closeout
- The documents due at the end of the job: O&M manuals, warranties, training, spare parts, as builts.
- Allowance
- The number of spec book reads and modification diffs your plan includes per month.
Screens in this guide show a sample project with example data. For help, write to support@sub-pro-ai.com.