Project Documents Guide

User Guide

BriefSpec

Introduction

Project Documents is the file library for a single project. Use it to store plans, contracts, evidence, spreadsheets, and other working files next to the work they belong to. Folders help you organize. Files keep a version history so a replacement does not lose the earlier copy’s identity. PowerPoint (.ppt / .pptx) is not in the upload allowlist — use PDF or Word for slide decks if needed.

This guide is for every role that can open Documents on a project. What you can do depends on your Project privileges. Some people can only browse and download. Others can create folders, upload, move, replace versions, and delete. If an action is not available, it is hidden or locked for your role, not missing from the product. Hover a disabled control to see why.

This guide explains how to open Documents, browse folders, search, upload files (Attach Files), manage versions, use the audit trail, and keep the document library tidy.

Accessing Documents

Open a project from All Projects. In the project sidebar, under Governance, select Documents.

The page title is Documents. Below the title is a search field with the placeholder Go to a file or folder…. The count on the right shows how many documents are in the project (for example, 12 documents). List and Grid view icons sit near New.

The left column is Folder navigation, with the subtitle Browse project files. All project files is the top of the library. The right column shows the contents of the folder you have selected. The breadcrumb above the list uses Project files as the root (for example, Project files / Contracts).

If Documents is not in the sidebar, it is not enabled on the project template, or your role does not have View access. If you open the page and see You do not have View access to Documents for this project, ask an Application Admin to grant the Documents View privilege (not Hidden).

Before you can use Documents:

  1. You must be able to open the Project.
  2. Documents must be available on the Project (Governance in the Project sidebar).
  3. Your role must have Documents View.
  4. Upload, folder create, move, version replace, download, audit trail (Activity), and delete each have their own privilege. Your administrator may grant All files or only files you uploaded (Own). When View is Own, a banner explains: Own scope: your View privilege is limited to documents you uploaded.

The Empty Project

When a project has no folders or files yet, Folder navigation shows No folders yet. Use New to create one. The main area title is No folders or files yet, with help text: Create a folder to organize project files, or upload files directly here — plus New folder and Upload files.

Use New folder to start a structure or Upload files to place files at the top of the library (All project files). You do not have to create a folder first. Files can sit at the root and be moved later. Inside an empty folder the title is This folder is empty. At maximum depth the empty state explains folders can be nested up to 5 levels and you can still upload files there.

Browsing Folders

Select All project files to see everything at the top level. Select a folder in Folder navigation to open it. The breadcrumb above the file list shows the path, for example Project files / Contracts.

Folders can be nested up to five levels. When you are at the deepest level, New shows Maximum folder depth reached — you can still upload files there, but you cannot create another sub-folder. Use New folder in Project files from the New menu if you need another top-level folder.

Two folders in the same location cannot share the same name. Folder names are limited to 60 characters and cannot contain \ / : * ? ” < > |.

List and Grid View

Use the list and grid icons in the header (tooltips List view and Grid view) to switch how contents are shown. List view is a table with Name, Owner, Date modified, File size, and Actions. Files show Version {n} under the name; folders show how many nested folders and files. Grid view shows folders and files as cards. BriefSpec remembers your choice for that project in the current browser session.

Search

Type in Go to a file or folder…. As you type, BriefSpec suggests matching folders and files (grouped under Folders and Files). Use the arrow keys and Enter to jump to a suggestion. Choosing a folder opens that folder. Choosing a file opens its folder and highlights the file. If nothing matches, you see No matching files or folders.

Press Enter without picking a suggestion (or use Search all results) to filter the current list by your text. An empty filter shows No folders or files match your search. Clear the search box to see the full folder again.

Creating Folders

If you can add documents, click New, then New folder. The menu header shows Create in {path}. New folder’s secondary line is Create inside {path}. Enter a Folder name (up to 60 characters) and Save. The dialog also shows Create inside with the destination path.

From inside a folder you can also choose New folder in Project files (Create another top-level folder) without leaving the page. Empty folders can be created first so the team has a place to upload. File names cannot be renamed in Documents — only folders use Rename folder. To revise a file, use Upload another version or upload a new file.

Uploading Files

Open the folder where the files should live, then click New → Upload files (secondary: Save files in {path}), or use Upload files on the empty state. The Attach Files window opens: paste (Ctrl+V), drag and drop, or Browse Files. You can select more than one file. Files are saved in the current folder.

Each file must be 20 MB or smaller. Types you can upload include:

  • Images: PNG, JPEG, GIF, WebP, BMP
  • Documents: PDF, Word (.doc, .docx), Excel (.xls, .xlsx), plain text (not PowerPoint)
  • Media: MP3, OGG, MP4, WebM

If a file is too large or the type is not accepted, that file is skipped and BriefSpec tells you which ones failed. Successful files still appear in the folder (for example, 3 document(s) uploaded).

Downloading Files

Use Download file on a file row or Download on a card to save a copy to your computer. Documents has no in-app file preview — download the file to open it locally. If Download is not shown or is locked, your role does not have the Download privilege, or Own scope limits you to files you uploaded.

Versions

Each file starts at version 1. Use Upload another version on a file to replace the stored file with a new one (single-file Attach Files). The file name in the library stays the same. The version number increases. Use this when a document is revised and you want one place for the current copy, not a second file with a new name.

Version replace is a single-file action. The replacement must also be 20 MB or smaller and an accepted type.

Moving Files and Folders

Use Move file on a file to place it in another folder, including Project files / All project files. Select several files to show the selection bar ({n} selected · Move · Delete) and move them together. In the Move dialog, search folders, pick a destination, then Move to {name}.

Use Move folder to change a folder’s parent. Nested folders and files move with it. You cannot move a folder into itself or in a way that would go deeper than five levels. With Own scope on Update, only the folder creator can move or rename that folder.

Renaming and Deleting Folders

Rename folder changes only the folder name (dialog title Rename folder). The files inside keep their names. You cannot rename a folder to a name that already exists in the same parent, or use forbidden characters / more than 60 characters.

Deleting Files

If your privilege is Own, you can delete only files you uploaded. Folders can be renamed, moved, or deleted only by the person who created them when Own scope applies.

File audit trail

What You Can Do Depends on Your Role

Documents privileges on the project control the buttons you see:

  • View – open the Documents page and browse folders and files you are allowed to see.
  • Add – create folders and upload files.
  • Update – move files, upload another version, and rename or move folders you are allowed to change.
  • Download – save a copy of a file.
  • Activity – open View audit trail (File audit trail) for a file.
  • Delete – remove files or folders.

Read means you can see the action area but cannot change files. Hidden means the action is not offered. Own means the action applies only to files you uploaded (or folders you created). Hover a disabled button to see why it is locked.

Important: Always confirm you are in the correct folder before you upload or delete. File delete and folder delete cannot be undone. Prefer Upload another version when you are revising an existing document, so the library stays one file per document. Documents does not link files to Backlog, Test Cases, or Scribe360 from this page — those links live on other screens.