Skip to main content

Agency Documents

Written by Sven Gerlach

Overview

The Documents tab on an agency's detail page is where MGA and carrier teams keep every supporting document collected during onboarding and beyond, including E&O, Cyber, and Crime & Fidelity policies, the agency's W9, and any other file you need to retain alongside the relationship. Uploaded policies and W9s are scanned automatically so you can verify coverage, dates, and tax-form details without opening the PDF.

What is the Documents Tab?

The Documents tab is your single per-agency document vault: upload a new policy or W9, let the platform pull the data off it, replace a renewed document in place, correct anything the automatic extraction got wrong, and keep a soft-deleted audit trail of everything you remove.

Who uses it. Licensing managers, onboarding specialists, and compliance teams at MGAs and carriers use this tab to verify that each downstream agency they distribute through has current insurance coverage and a complete, signed tax form on file before authorizing them to write business.

What you can do here:

  • Upload one document per agency in each of the four structured categories (E&O Policy, Cyber Policy, Crime & Fidelity, W9), plus unlimited supporting files as Other Document

  • See policy data (policy number, carrier, coverage limits, effective and expiry dates, address) pulled automatically from the uploaded PDF

  • See every IRS Form W9 field (name, business name, tax classification, exemptions, address, account numbers, SSN/FEIN, and whether it's signed) extracted from the uploaded W9

  • Open a side-by-side details panel to verify what the extractor pulled without leaving the page

  • Open or download the underlying file in one click

  • Replace a renewed policy or W9 in place by uploading a new version, keeping the same row and any manual corrections

  • Manually correct any extracted field when automatic extraction is incomplete or wrong

  • Rename a document so the Name column stays human-readable

  • Soft-delete a document to hide it from the default view while preserving it for audit

  • Toggle the Deleted filter to inspect everything that has been removed

Accessing the Documents Tab

Left sidebar → Agencies → click any agency row → Documents tab.

What is visible on the page:

Element

What it shows

Filter

Badge-style status filter with Active (default) and Deleted chips. Multiple statuses can be selected together. A ? popover reads You can filter documents by status. Multiple statuses can be selected all at once.

New button

Top-right of the tab. Opens the New Document slide-over for uploading a fresh document. Hidden when the agency association is soft-deleted.

Name column

The document's display name. For policy and W9 uploads this is the name entered at upload time; for Other Document it is the free-text name entered in the form.

Category column

The document's classification: E&O, Cyber, Crime & Fidelity, W9, or Other Document.

Row menu (three-dot icon at the end of each row)

Opens a popover with row-level actions (see Row Actions below).

Empty state

If no documents match the current filter, a panel reads No documents available — You can add a document by clicking on the "New" button.

There is no full-page detail view — everything is done from the inline row menu (the three-dot icon at the end of each row) and the slide-overs it opens.

Uploading a New Document

When you'd do this. A new agency has just sent over their E&O policy or W9 during onboarding, or an existing agency has emailed you a renewal certificate, an addendum, or any other supporting file you need to keep on record.

  1. Open Left sidebar → Agencies → [agency row] → Documents.

  2. Click New in the top-right of the tab. The New Document slide-over opens.

  3. Drag and drop the file into the upload box, or click to browse. Accepted formats are JPEG, JPG, PNG, and PDF, up to 25 MB.

  4. Fill in the fields:

Field

Required

Description

File

Yes

The document itself. Drag-and-drop or browse. JPEG / JPG / PNG / PDF, 25 MB maximum.

Document Name

Yes

The display name shown in the Name column. Example: Travelers E&O 2026-2027.pdf.

Document Category

Yes

The classification: E&O Policy, Cyber Policy, Crime & Fidelity, W9, or Other Document. The first four are hidden from the dropdown if an active document already exists in that category.

  1. Click Save. The slide-over closes and the new row appears in the table.

Once the upload completes, E&O, Cyber, Crime & Fidelity, and W9 documents are queued for automatic data extraction. The result shows up as a Data Extraction Status badge on the View Details panel and updates as the extractor progresses through queued → processing → success (or error). Other Document uploads are not extracted.

Note: The four structured categories (E&O Policy, Cyber Policy, Crime & Fidelity, W9) each allow only one active document at a time. If an active document already exists in a category, that option is hidden from the Document Category dropdown — use Upload on the existing row to replace it instead.

Tip: For renewals, use Upload on the existing policy or W9 row rather than uploading a brand-new document. That keeps the row, name, and any manual corrections tied to the same record.

Row Actions

Open the row menu (three-dot icon at the end of any row) to access these actions. Some are disabled based on the document's state, whether extracted data is present, and whether the agency association itself has been soft-deleted — disabled items show a tooltip explaining why.

Action

When you'd use it

Disabled when

View Details

Inspect the data the extractor pulled from a policy or W9.

The document has no extracted data (typical for Other Document).

View Document

Open the underlying file in a new browser tab.

Never — always available.

Download

Save the file to your machine.

Never — always available.

Rename

Fix a typo in the Name column or rewrite the name to follow your filing convention.

The document is soft-deleted, or the agency association is soft-deleted.

Upload

Replace the file with a new version (renewal, corrected scan, etc.) while keeping the row.

The document is soft-deleted, or the agency association is soft-deleted.

Update

Correct extracted data (policy fields, W9 fields, etc.) without touching the file.

No extracted data exists yet, or the document is soft-deleted, or the agency association is soft-deleted.

Delete

Remove the document from the default view while preserving it for audit.

The document is already soft-deleted, or the agency association is soft-deleted.

Warning: Upload replaces the file in place — the previous version is not retained as a separate row. If you need to keep the prior PDF on record, Download it first, or upload the new file as a new Other Document instead.

Viewing Document Details

When you'd do this. Right after uploading a policy or W9, to confirm the extractor pulled the right values; or whenever a teammate asks you to verify what coverage or tax details you have on file for an agency.

  1. Open the row menu and select View Details. A slide-over titled Document Details opens, with the document's name as the subtitle.

  2. The body shows a data card. The shape depends on the category.

For E&O, Cyber, and Crime & Fidelity policies — the policy card shows:

Field

What it shows

Primary Insured

The named insured printed on the policy (shown as the card heading).

Also insured

Any additional insureds (only shown when one or more are present).

Data Extraction Status

A colored badge in the card header: not-started, queued, processing, success, or error.

Policy Number

The carrier-assigned policy number.

Carrier

The insurance carrier issuing the policy.

Address

The mailing address attached to the policy (Line 1, optional Line 2, City, State, Zip).

Effective Date

The policy's effective date.

Expiry Date

The policy's expiry date.

Coverage → Total

Aggregate coverage limit, formatted as USD currency.

Coverage → Per Claim

Per-claim coverage limit, formatted as USD currency.

For W9 documents — the W9 card shows the full IRS Form W9, grouped by form section:

Section

Fields shown

Card header

The W9's file name plus the Data Extraction Status badge (not-started, queued, processing, success, or error).

Filer (lines 1-2)

Name (line 1), Business name (line 2).

Tax classification (line 3)

Federal tax classification (Individual / Sole proprietor / Single-member LLC, C corporation, S corporation, Partnership, Trust / estate, Limited liability company, or Other), LLC sub-letter (C / S / P), Other description, and Has foreign partners, owners, or beneficiaries (line 3b).

Exemptions (line 4)

Exempt payee code, FATCA reporting exemption.

Address (lines 5-6)

Address, City, state, ZIP.

Account numbers (line 7)

Account number(s).

Taxpayer identification number (Part I)

SSN (obscured until you reveal it) and EIN / FEIN.

Certification (Part II)

Signature present — whether a signature was detected on the form.

Any field the extractor could not read shows an em-dash ().

If the document has no extracted data (typical for Other Document), the slide-over shows We could not find any metadata for this document — This document does not have any metadata associated with it. Use View Document to inspect the file itself instead.

Updating Document Metadata

When you'd do this. Automatic extraction returned error, left a field blank, or got something wrong (a misread policy number, the wrong carrier, a missing W9 signature flag). Update lets you patch the extracted fields manually without re-uploading the file. The slide-over header reads Update Policy: <name> for every category; the form inside depends on whether the row is a policy or a W9.

For E&O, Cyber, and Crime & Fidelity policies — the form is titled Update Policy Details:

Field

Required

Description

Primary Insured

Yes

Name of the primary insured on the policy. Example: Acme Insurance Agency LLC.

Policy Number

Yes

The carrier-assigned policy number.

Address Line 1

Yes

Street address for the policy's mailing address.

Address Line 2 (Optional)

No

Suite, floor, or unit number.

City

Yes

City for the policy address.

State

Yes

US state or territory, selected from a dropdown.

Zip Code

Yes

Zip code for the policy address.

Other Insured

No

Comma-separated list of additional insureds. Example: Acme Holdings, Acme East Branch.

Insurance Carrier

Yes

Name of the carrier issuing the policy. Example: Hartford.

Effective Date

Yes

Date picker; the date the policy takes effect.

Expiry Date

Yes

Date picker; the date the policy expires.

Aggregate Coverage

Yes

Total coverage limit in USD, formatted as currency (e.g., $1,000,000).

Per Claim Coverage

Yes

Per-claim coverage limit in USD, formatted as currency (e.g., $500,000).

Click Update Policy to save. A success notification confirms the change (e.g., E&O policy updated successfully); on failure you'll see an error notification.

For W9 documents — the form lets you edit every parsed W9 field, grouped the same way as the details view:

Field

Required

Description

Name (line 1)

No

Name as shown on the filer's income tax return.

Business name (line 2)

No

Business name or disregarded entity name, if different from line 1.

Federal tax classification

Yes

Dropdown: Individual / Sole proprietor / Single-member LLC, C corporation, S corporation, Partnership, Trust / estate, Limited liability company, or Other.

LLC tax classification (C / S / P)

Conditional

Dropdown shown only when Limited liability company is the selected classification.

Other classification description

Conditional

Free-text box shown only when Other is the selected classification. Example: Nonprofit.

Has foreign partners, owners, or beneficiaries (line 3b)

No

Toggle shown only for flow-through classifications (Partnership, Trust / estate, or an LLC taxed as a Partnership).

Exempt payee code

No

Line 4 exempt payee code.

Exemption from FATCA reporting code

No

Line 4 FATCA exemption code.

Address (line 5)

No

Number, street, and apt. or suite no.

City, state, ZIP (line 6)

No

City, state, and ZIP code.

Account number(s)

No

Line 7 account number(s).

SSN

Conditional

Social Security Number, entered as 123-45-6789. Either SSN or FEIN must be present for a valid W9.

FEIN

Conditional

Nine-digit Federal Employer Identification Number, entered as 123456789. Either SSN or FEIN must be present for a valid W9.

Signature present

No

Toggle indicating whether the form is signed (Part II certification).

Click Update W9 to save.

Note: Update is enabled only for documents that already have extracted data. Other Document rows are stored without extracted data, so the action is disabled and the tooltip reads This document does not have any metadata associated with it.

When a W9 Fails Validation

When this happens. Right after you upload a W9 and its extraction finishes, the platform checks the parsed form against the IRS Form W9 requirements. If the W9 is missing something required, a modal pops up automatically titled W-9 does not comply with the following requirements, listing exactly what's wrong:

  • Form — Fields 1, 3, 5 and 6 are required (name, tax classification, and address).

  • Part 1 — Either SSN or FEIN/EIN must be provided.

  • Part 2 — Document must be signed.

Click I understand to dismiss the modal. The W9 row's Data Extraction Status badge will read error. From there, either ask the agency for a corrected, complete W9 and replace the file with Upload, or open Update and fill in the missing fields manually.

Note: This modal fires only on a freshly uploaded W9 that transitions to error — it does not pop up again every time you reopen the tab on an existing failed W9.

Replacing a Document with a New Version

When you'd do this. A renewal arrives for an existing E&O, Cyber, Crime & Fidelity, or W9 record, or the agency emails a corrected scan and you want to swap the file without losing the row and any manual corrections you've made.

  1. Open the row menu on the document you want to replace and select Upload. A slide-over titled Upload Document: <name> opens with the subtitle Upload the new document version.

  2. Drag and drop the new file or browse to attach it. Same constraints as initial upload: JPEG, JPG, PNG, or PDF, up to 25 MB.

  3. Click Upload.

The new file replaces the existing one in place. The row's Name and Category stay the same, and the extractor re-runs against the new file.

Renaming a Document

When you'd do this. The original name is unclear (scan_001.pdf), your team has a naming convention to enforce, or a typo crept into the name entered at upload time.

  1. Open the row menu on the document and select Rename. The slide-over Rename Document: <current name> opens.

  2. Edit the Document Name field. Example: Travelers E&O 2026-2027.pdf.

  3. Click Save.

Renaming changes only the display name in the Name column — the underlying file and its extracted data are unaffected.

Deleting a Document

When you'd do this. A policy has lapsed and is no longer needed in the active view, or a wrong file was uploaded and you want to take it out of circulation while keeping the audit trail.

  1. Open the row menu on the document and select Delete.

  2. A confirmation modal opens titled Delete Document with the message This will mark the document as deleted. Deleted documents will still be accessible in the system but will be clearly labeled as deleted.

  3. Click Delete to confirm, or Cancel to back out.

Deleted documents are hidden from the table by default. Switch the Filter to Deleted to bring them back into view; Download and View Document still work from the deleted row so you can pull the file from the archive at any time.

Filtering and Searching

A single status filter sits above the table. There is no search box on this tab — the filter is the only knob.

Filter

Type

Purpose

Example use

Filter (status)

Multi-select badge group

Limit rows to Active or Deleted documents.

Auditing what's been removed in the last cycle? Tick Deleted and untick Active to see only soft-deleted rows.

By default only Active documents are shown. Selecting both badges shows everything together. The selection is persisted in the URL so a filtered view can be shared or bookmarked.

Visual Indicators

Element

Color / Label

Meaning

What to do about it

Data Extraction Status badge

not-started (neutral)

The extractor has not yet picked up the document.

Wait a few seconds, then refresh. If the badge does not advance, use Update to enter the data manually.

Data Extraction Status badge

queued

The document is waiting in the extraction queue.

Wait — the badge will advance to processing automatically.

Data Extraction Status badge

processing

The extractor is reading the document.

Wait — usually completes in under a minute for a typical policy or W9 PDF.

Data Extraction Status badge

success

Data was extracted.

Open View Details and confirm the fields look right. If anything is wrong, click Update to correct.

Data Extraction Status badge

error

Extraction failed (unreadable scan, unsupported layout) or the W9 failed validation (missing required fields, no signature, or no SSN/FEIN).

Use Update to fill in the data manually, or Upload a corrected file. For a W9, the failure reasons are listed in the W-9 does not comply modal.

Filter badge

Active (green)

The default status filter — non-deleted documents.

None — leave on by default.

Filter badge

Deleted (red)

Filter for soft-deleted documents.

Toggle on when reviewing what's been removed. Use Download to retrieve a file from the archive.

Disabled row action

Greyed-out menu item with tooltip

The action does not apply to this document right now.

Hover the tooltip to read why (e.g. This document does not have any metadata associated with it, This document has been deleted or association is deleted).

Frequently Asked Questions

Why is the E&O Policy (or Cyber, Crime & Fidelity, W9) option missing from the Document Category dropdown? The agency already has an active document in that category. Use Upload on the existing row to replace it, or delete the existing one first. The category becomes available again once no active document exists for it.

What is the difference between Upload, Update, and Rename? Upload replaces the underlying file with a new version (keeps the row, re-runs extraction). Update edits the extracted data (policy fields or W9 fields) without touching the file. Rename changes only the display name shown in the Name column.

Why is View Details greyed out on my document? View Details is only available for documents that have extracted data. Other Document rows are stored without extracted data, so the action is disabled and the tooltip reads This document does not have any metadata associated with it.

My policy or W9 data was extracted incorrectly. What should I do? Open the row menu and select Update. Correct the fields, then click Update Policy (or Update W9 for a W9). The next time someone opens View Details they will see the corrected values.

A modal popped up saying my W-9 doesn't meet the requirements. What does that mean? The uploaded W9 was missing something the IRS form requires — a name/classification/address (Form fields 1, 3, 5, 6), a taxpayer ID (SSN or FEIN/EIN), or a signature (Part 2). Ask the agency for a complete, signed W9 and replace the file with Upload, or fill in the missing fields yourself with Update.

What happens when I delete a document? The document is soft-deleted: the row is hidden from the default view but remains in the system. Switch the Filter to Deleted to bring it back into view; View Document and Download still work so the file can be downloaded and audited.

What file types and sizes are allowed? JPEG, JPG, PNG, and PDF files are accepted, up to 25 MB per file. Other formats are rejected at the upload step with a validation error.

Why are all the row actions disabled on my document row? The agency association itself has been soft-deleted. Every write action (Rename, Upload, Update, Delete) is locked until the agency association is restored. Read actions (View Document, Download, View Details when data exists) continue to work.

Best Practices

  1. Upload policy and W9 documents as soon as they arrive. Automatic extraction starts immediately, so by the time you open View Details the key fields are usually already populated.

  2. Verify extracted data after every upload. Open View Details on the new row. If the Data Extraction Status badge is error or any field looks wrong, click Update and fix it before someone else relies on the data.

  3. Treat a W-9 validation error as a request, not a typo. When the W-9 does not comply modal appears, the form genuinely lacks a required field or signature. Prefer getting a corrected W9 from the agency over patching it manually, so your record matches the signed original.

  4. Replace renewals in place with Upload. Don't delete the prior policy and create a new row — use Upload on the existing row so the Name, manual corrections, and audit history stay together.

  5. Adopt a consistent naming convention. Include the carrier and policy year in the Document Name (for example, Travelers E&O 2026-2027) so the table is scannable at a glance, especially when filtering between Active and Deleted.

  6. Review the Deleted filter periodically. Toggle Filter → Deleted during quarterly audits to make sure nothing was removed in error. Deleted documents are retained indefinitely, so a forensic download is always possible.

Related Pages

Need Help?

If you have questions about the Documents tab or encounter any issues, contact our support team at support@turris.com.

Did this answer your question?