Where the Documents section on an item handles Word-template-driven generated documents (Staff Reports, Resolutions, etc. — see Generating Documents from Templates on an Item), the Attachments section handles everything else: PDFs, images, presentations, supporting exhibits, maps, certified copies, supplementary materials. Anything you have as a file and want to associate with the item ends up here.
This article walks through the Attachments section: how it's organized by Attachment Type, the upload flow (drag-drop, type selection, security level), drag-reorder, the "Uncategorized Attachments" catch-all, and what attachments look like once they're attached.
Where to find it
On any item display page (/legislative-items/[id]), scroll past the Documents and Public Documents sections to the Attachments section. It has a paperclip icon.
IMAGE: The Attachments section on an item showing multiple type-specific blocks plus the upload zone.
The Attachments section is always available on items — no subscription module is required. Unlike Documents (which requires the Word Integration module), attachments work for every government.
How attachments are organized
The Attachments section is divided into blocks, one per Attachment Type configured on this item's item type, plus a final Uncategorized Attachments block as a catch-all.
IMAGE: The Attachments section showing blocks for each Attachment Type
with files counts.
For example, a Resolution item type might have these blocks:
Exhibits (3 Files)
Public Notice (1 File)
Supporting Materials (0 Files)
Uncategorized Attachments (0 Files)
Each block shows:
Block title — the Attachment Type's name.
Required badge (red outline) — appears when the type is configured as required AND no files are currently in the block. A reminder that the workflow may block submission until the block is populated.
File count badge (top-right) — how many files are currently in the block.
The Uncategorized Attachments block
The catch-all at the bottom of the section. Holds files that:
Were uploaded without picking a specific Attachment Type.
Were uploaded against a type that's since been removed from the item type's configuration.
Don't fit any of the configured types.
The Uncategorized block always exists, even when empty. It's a safety net so files never get orphaned.
Required types
Some Attachment Types are configured as required on the item type. The block shows a red Required badge when empty. If submission is attempted with required attachment blocks still empty, the Submit For Review validation will surface the missing-attachment requirement.
For details on configuring Attachment Types, see Managing Attachment Types in the admin docs.
Uploading attachments
At the bottom of the Attachments section, the Upload Block has the upload UI.
IMAGE: The Upload Block showing the dropzone and the per-file configuration list.
The Dropzone
Drag and drop files onto the dropzone, or click to open a file picker. Multiple files can be selected at once.
Supported file types: anything. Govinity stores any file type — PDFs, Word documents, Excel files, images, videos, presentations, ZIP archives. Govinity doesn't restrict by extension; you upload, you store, you reference.
Max file size: 100 MB per file. Larger files are rejected by the uploader. For very large files (videos, GIS data), consider hosting externally and uploading a reference document instead.
Per-file configuration
For each file added to the dropzone, a row appears below with editable per-file metadata:
IMAGE: A per-file row in the upload list showing status icon, name,
Attachment Type, Security Level fields.
Status icon — Waiting (clock) → Uploading (cloud with progress bar) → Done (check) → Error (X).
Name — the file's display name. Defaults to the original filename; you can edit before uploading.
Attachment Type — a dropdown to assign the file to one of the item type's configured Attachment Types, or to None for the Uncategorized block.
Security Level — a dropdown (Public, Internal, Confidential, Restricted).
Users with access — appears only when Security Level is Restricted, lets you pick specific users.
Trash icon — removes the file from the upload batch (doesn't delete the source file from your computer).
What the Attachment Type dropdown shows
The dropdown shows:
One option per configured Attachment Type for this item type (e.g., Exhibits, Public Notice, Supporting Materials).
A None option that puts the file in the Uncategorized Attachments block.
The dropdown auto-filters to types relevant to your item type. Attachment Types configured for other item types don't appear here.
Security Level
Same three-tier model as elsewhere in Govinity:
Public — visible to all staff regardless of role. Eligible for publishing publicly.
Internal — visible to staff in specific roles.
Confidential — restricted to specific roles.
Restricted — restricted to specific users selected via the Users with access multi-select.
Most attachments will be Public (the file is intended to be public) or Internal (the file is internal documentation, not for citizens). Confidential and Restricted are for sensitive supplemental materials.
Naming
The default name comes from the original filename. Customize for clarity:
"Exhibit A - Site Plan" instead of "site_plan_v3_FINAL_revised.pdf"
"Public Hearing Notice - June 15 2025" instead of "Notice.pdf"
"Resolution 2025-42 Signed Copy" instead of "scan_20250615.pdf"
Citizens see attachment names on the public portal (when the item is on a published agenda), so make the names readable and informative.
What happens on upload
When you click Upload (or the action that starts the upload), the uploader:
Generates a signed URL for each file (so uploads go directly to Govinity's secure storage, not through the browser's main connection).
Uploads each file in the batch, updating the per-file status icon as it progresses.
Creates the attachment record in Govinity's database with your configured metadata.
After all files complete, the uploaded files appear in the corresponding Attachment Type blocks above (or the Uncategorized block if no type was assigned).
You don't have to keep the page open during upload, but Govinity needs the browser to confirm the upload completed — so plan to wait until the batch finishes before navigating away.
After upload — managing existing attachments
Once attachments are in their blocks, you can:
IMAGE: An attachment row showing reorder handle, file name, type, security level, and action buttons.
Reorder within a block
Each attachment block supports drag-and-drop reordering. Grab the grip handle on any attachment row and drag up or down to reposition.
The order persists across staff and public views — so put the most important attachments first in each block. Useful for agendas where attachments are presented in a specific reading order.
Edit attachment metadata
Click an attachment row (or its edit affordance) to update:
Name — rename for clarity.
Security Level — change visibility.
Type — move the attachment to a different block, including to/from Uncategorized.
View / Download
A view or download action on each row opens the attachment in a new browser tab (for browser-renderable files like PDFs and images) or triggers a download (for other file types).
Delete an attachment
Each attachment has a delete action (trash icon) with a confirmation prompt. Deletion is permanent — the file is removed from Govinity's storage. Plan accordingly.
For attachments associated with workflows or public agendas, deletion may affect downstream flows (e.g., the Agenda Package PDF may need to be regenerated).
Common patterns
A few patterns that come up:
"I have 5 PDF exhibits for this item; let me upload them all." Drag all 5 PDFs onto the dropzone. Pick Exhibits as the Attachment Type for each (or use a default that gets applied to all). Set Security Level Public. Click Upload. The 5 files appear in the Exhibits block, ready to be reordered.
"I want to attach a 200 MB GIS dataset." Too large to upload directly — the 100 MB cap blocks it. Either: upload a reference document with a link to where the GIS data lives, or contact Govinity support about a special upload path.
"I need to update an attachment file but keep its place in the order." Delete the old attachment, upload the new one with the same metadata, and drag it to the same position.
"This attachment was put in the wrong block." Edit the attachment's Type, picking the correct one from the dropdown.
"I have a signed copy of the resolution to attach after the meeting." Upload as Public Notice (or whatever type makes sense), Security Level Public, named clearly ("Resolution 2025-42 Signed Copy"). The attachment will appear on the public portal alongside the agenda materials.
"I want to attach an old document but it's still in Word format." Convert to PDF first for best public-portal display, then upload.
Common questions
Can I upload Word documents to Attachments? Yes — any file type works. But for documents that should integrate with the item's substance (Staff Report, Resolution), use the Documents section with its template-based Word integration instead. Save Attachments for supplementary files (exhibits, presentations, signed copies).
What's the difference between Documents and Attachments? Documents = templated Word files generated from Govinity Document Templates (Staff Report, Resolution, etc.). They're authored in the item's workflow and have rich features like Sync values, Assign Number, and Publish/Unpublish. Attachments = uploaded files (any format) that supplement the item. Drag-drop with basic metadata.
Can I bulk-publish attachments? Not in bulk. Each attachment has its own visibility (controlled by Security Level + the item's agenda publish state). For making attachments publicly visible, the item itself needs to be on a published agenda.
What happens to attachments when the item is closed? Closed items keep their attachments. Attachments remain accessible (and on the public portal if the item was on a published agenda).
Can I add attachments after the item is in Review? Depends on field-level workflow permissions (see Why Your Form Looks Different Right Now). Some workflow steps allow attachment editing; some don't.
Can I copy attachments from one item to another? When you Copy Item (see Copying, Restoring, and Changing an Item's Status), you can opt to copy attachments along with the item. Otherwise, attachments are item-specific.
How long are attachments stored? Indefinitely. Storage is part of your subscription.
Can citizens see all my attachments? Citizens see attachments only when: 1. The item is on a published agenda, AND 2. The attachment's Security Level is Public.
Internal, Confidential, or Restricted attachments are never publicly visible.
What this article doesn't cover
Document templates and Word integration — see Generating Documents from Templates on an Item.
Public Documents (snapshots of published documents) — covered in the Generate Documents article.
Attachment Type configuration — see Managing Attachment Types in the admin docs.
The agenda packet (which includes attachments) — see Finalizing and Publishing the Agenda.
What to read next
Submitting an Item for Review — the natural next step after attachments are in place.
Generating Documents from Templates on an Item — the companion article for Word-template documents.
The Item Workflow Sidebar — for how attachments fit into workflow status.
Need help?
If an attachment upload fails repeatedly, check the file size (100 MB max) and try a fresh upload. If a required block won't clear its red badge, make sure the file is actually attached (not just sitting in the upload queue). For anything else, reach out to Govinity support.





