Das Benutzerhandbuch ist auf Englisch und Bulgarisch verfügbar. Sie lesen die englische Fassung.

Folders, uploading and navigation

Auf dieser Seite
  1. The file manager screen
  2. How to create a folder
  3. How to create a new blank document
  4. How to upload files
  5. How to upload a whole folder
  6. How to rename a file or folder and add a description
  7. How to move files and folders
  8. How to copy files and folders
  9. How to download files
  10. How to select several files
  11. On a phone
  12. Messages you may see
  13. Common questions
  14. Related
WhereCompany sidebar → Files (Файлове), /companies/{company}/files; project sidebar → File manager (Файлов мениджър), /projects/{project}/files; a folder: …/files/folder/{folder}
Who canFile manager (Файлов мениджър) View (Преглед) to browse, open and download; Edit (Редакция) to create, upload, move, copy, rename and delete. Inside a subfolder you also need Edit access to that folder through sharing. Any member with Edit can create folders and upload at the top level.
RelatedViewing and editing documents, Sharing, comments and mentions, Trash and restoring

The file manager screen

The file manager page has a header with the page title File manager (Файлов мениджър), the name of the company or project, and the tabs. Below it is an action bar, the folder tree on the left and the content of the open folder on the right.

File manager screen with tabs, action bar, folder tree and file list
Figure: The parts of the file manager screen.
  1. The tabs Files (Файлове), BoQ documents (КСС документи) or Letterheads (Шапки), and Trash (Кошче) switch between the ordinary file tree, the system documents and the deleted items.
  2. The breadcrumb shows where you are; click any level to go back up.
  3. The search field Search files… (Търси файлове…) filters the open folder or searches every folder.
  4. The switch List (Списък) / Grid (Мрежа) changes between a table and thumbnails.
  5. The buttons New (Нов), Upload folder (Качи папка) and Upload file (Качи файл) add content to the open folder.
  6. The Folders (Папки) tree shows every folder you can see; drag its right edge to resize it.
  7. The storage meter at the bottom of the tree shows how much of the company's storage is used.

Tabs

TabWhere it appearsWhat it holds
Files (Файлове)Company and projectYour folders and files.
Letterheads (Шапки)Company onlyExcel header templates used when you export a BoQ. See Viewing and editing documents.
BoQ documents (КСС документи)Project onlyThe original workbooks of BoQ imports and every BoQ export. See Viewing and editing documents.
Trash (Кошче)Company and projectItems deleted in the last 30 days. See Trash and restoring.

The folder tree and the breadcrumb

The Folders (Папки) panel on the left of the file manager lists the folders as a tree. Click a folder to open it, click the arrow next to it to expand or collapse its subfolders. Use Collapse tree (Свий дървото) and Expand tree (Разгъни дървото) to hide or show the whole panel, or double-click the grip between the tree and the list. The tree shows only folders you can see. If someone shares a single file deep inside a folder structure with you, you see the parent folders needed to reach it, but not the other unshared content in them.

The breadcrumb above the list starts with the company or project name and lists every parent folder. A number prefix written as "00 · " at the start of a folder name is hidden in the breadcrumb, so "01 · Drawings" reads as "Drawings". Numbering folders this way keeps them in your preferred order in the list.

List and grid view

In List (Списък) view the file manager shows a table. By default it shows the columns Name (Име), Version (Версия), Size (Размер) and Modified (Променен). The Columns (Колони) menu, the small icon next to the view switch, adds Description (Описание), Indicators (Индикатори), Markups (Маркирания) and Updated by (Обновен от). Click a column header to sort by it. In Grid (Мрежа) view every file appears as a card with a thumbnail.

Chip or badgeMeaning
New (Нов)The file was uploaded in the last 7 days and has only one version.
Revised (Преработен)A new version of the file was added in the last 7 days.
Not processed, Pending processing, Processing, Ready for viewing, Processing errorThe state of a 3D/CAD model. See 3D/BIM models and processing credits.

Opening a file

A single click on a file in the file manager opens it. What opens depends on the file type:

File typeWhat a click does
.docx, .xlsx, .xls, .pdf, .md, .txt, .csvOpens the in-browser editor on its own page.
.html (AI-created artifact)Opens the page in a protected viewer.
3D/CAD model with status Ready for viewingOpens the 3D viewer.
3D/CAD model not processed yet or with an errorOpens the processing dialog if you can edit files; otherwise shows This model has not been processed yet — ask someone who can edit files to process it.
3D/CAD model being processedShows This model is still being processed — it opens in the 3D viewer as soon as it is ready.
Images and other previewable filesOpens Quick preview (Бърз преглед) in a window.
Anything elseNothing opens; download the file to open it on your computer.

A click on a folder opens it. Press Enter on a focused row to open it from the keyboard.

The item menu

Right-click a file or folder in the file manager, or click the ⋯ button at the end of its row, to open its menu. Right-click on empty space opens a menu with New folder (Нова папка), the new-document types, Upload (Качване) and Upload folder (Качи папка).

Context menu of a file in the file manager
Figure: The menu of a file.
  1. Quick preview (Бърз преглед) shows the file in a window without leaving the folder.
  2. Open (Отвори) opens the file in the editor or viewer.
  3. Download (Изтегли) saves the current version to your computer.
  4. Edit details (Редактирай детайли) changes the name and the description.
  5. Move (Премести) and Copy to… (Копирай в…) put the file in another folder.
  6. Version History (История на версиите), Share (Споделяне) and Details (Детайли) open the versions, the sharing dialog and the details panel.
  7. Delete (Изтрий) moves the file to the Trash; it appears only if you have Edit access to the file.
Menu itemFilesFoldersAccess needed
Process (Обработи)Unprocessed 3D/CAD models—Edit on the file, File manager Edit
Quick preview (Бърз преглед)Yes—Read
Open (Отвори)YesYesRead
Download (Изтегли)Yes—Read
Edit details (Редактирай детайли)YesYesEdit
Move (Премести)YesYesEdit on the item and on the target folder
Copy to… (Копирай в…)YesYesRead on the item, Edit on the target folder
Version History (История на версиите)Yes—Read to view, Edit to restore or upload
Share (Споделяне)YesYesOnly the item's owner can change sharing
Details (Детайли)YesYesRead
Process all models (Обработи всички модели)—YesFile manager Edit
Delete (Изтрий)YesYesEdit

The details panel

Choose Details (Детайли) in the item menu to open the details panel on the right of the file manager. It shows a preview, Size (Размер), Updated (Обновен), Author (Автор), the number of Versions (Версии), when the file was last edited, and the description. For a processed 3D model it also shows counts of model elements and markups.

How to create a folder

  1. Open the folder in which the new folder should go, or stay at the top level.
  2. Click New (Нов) in the action bar and choose New folder (Нова папка). You can also right-click empty space in the list or use the new-folder button in the Folders panel.
  3. The dialog New folder (Нова папка) shows Creating in: {folder} (Създаване в: {folder}). Type the Folder name (Име на папката), for example "05 · Correspondence".
  4. Click Create (Създай). The message Folder created · "{name}" confirms it.

A folder created at the top level is private to you until you share it. A folder created inside a shared folder gets the sharing of its parent automatically. To create a folder inside another folder you need Edit access to that folder.

How to create a new blank document

You can create a document directly in the file manager, without uploading anything.

  1. Open the target folder and click New (Нов).
  2. Choose the type: Word document (Word документ), Excel workbook (Excel таблица), Markdown document (Markdown документ), Text file (Текстов файл) or CSV table (CSV таблица).
  3. In the dialog, for example New Word document (Нов Word документ), type the File name (Име на файла). The default is "Untitled" (Без име).
  4. Confirm. The message Created "{name}" appears and the document opens in the editor.

If the name is already taken in that folder, the new file gets a numbered name such as "Report (1).docx". If creation fails you see Could not create the file.

The New menu of the file manager with the document types
Figure: The New menu of the file manager.
  1. The New (Нов) button in the action bar opens the menu.
  2. New folder (Нова папка) creates a folder in the open folder.
  3. The document types Word document, Excel workbook, Markdown document, Text file and CSV table create a blank document.
  4. Process all models (Обработи всички модели) appears when you can process 3D/CAD models in this folder.

How to upload files

  1. Open the folder where the files should go.
  2. Click Upload file (Качи файл). The dialog shows Uploading to: {folder} (Качване в: {folder}).
  3. Drag files into the area Drop files here or click to choose (Плъзнете файлове тук или кликнете), or click it to pick files on your computer. You can choose several files at once.
  4. Click Upload (Качване). Each file shows {name} uploaded successfully when it is stored.

The quicker way is to drag files from your computer straight onto the file list. The list shows Drop files here (Пуснете файловете тук) and Uploading to: {folder} while you drag.

When a file with the same name already exists in the folder, the new file is uploaded under a numbered name and you see {original name} uploaded as "{new name}", for example "Plan (1).pdf". Nothing is overwritten. To replace a file and keep its history, upload a new version instead; see Versions.

A new file uploaded into a shared folder is visible at once to everyone the folder is shared with, and they get a notification such as {name} uploaded 3 files to "{folder}". A file uploaded at the top level stays private to you until you share it. When you upload 3D/CAD models, BuildColab asks whether to process them; see 3D/BIM models and processing credits.

How to upload a whole folder

Upload a folder from your computer when you move an existing archive into BuildColab. The file manager recreates its subfolders exactly.

  1. Open the folder that should receive the uploaded folder.
  2. Click Upload folder (Качи папка) and choose a folder on your computer, or drag a folder from your computer onto the file list.
  3. The Upload (Качване) panel opens in the corner and shows Preparing folders… (Подготвяне на папките…) while it creates the folder structure.
  4. If some files have the same name as a file already in their folder, the dialog Some files already exist (Някои файлове вече съществуват) asks what to do. Choose one option and click Continue (Продължи), or click Cancel upload (Откажи качването).
  5. Follow the progress: Uploading {done} of {total}. When it finishes the panel shows a summary such as 12 uploaded · 2 skipped · 1 failed.
  6. If some files failed, click Retry failed ({count}) (Опитай отново неуспешните). Click Close (Затвори) when you are done.
Choice in "Some files already exist"What happens
Upload as a new version (Качи като нова версия)The existing file keeps its name and its version history; the uploaded file becomes its newest version.
Keep both (Запази и двата)The new file gets a numbered name, for example "Plan (1).pdf".
Skip these files (Пропусни тези файлове)Only files that are not there yet are uploaded.

In the Upload panel each file has a status: Waiting (Изчаква), Uploading (Качва се), Uploaded (Качен), New version (Нова версия), Skipped (Пропуснат) or Failed (Неуспешен). Cancel remaining (Откажи останалите) stops the files that have not started yet; files already uploaded stay. Hide details and Show details collapse and expand the list. For very large folders BuildColab cannot check every name in advance; it then tells you that a file whose name is taken gets a numbered name, so nothing is overwritten.

The Upload file dialog with its drop area
Figure: The Upload file dialog of the file manager.
  1. The line Uploading to: {folder} shows the target folder.
  2. The drop area Drop files here or click to choose accepts files dragged from your computer or opens the file picker.
  3. The hint lists typical types: PDF, DWG, RVT, IFC, XLSX, DOCX and images.
  4. The Upload (Качване) button starts the upload.

How to rename a file or folder and add a description

  1. Right-click the item and choose Edit details (Редактирай детайли).
  2. Change the Name (Име). For a file you can leave out the extension: if the new name has no extension, the old one is kept.
  3. Optionally type a Description (Описание), placeholder Short description (optional). It can be up to 2,000 characters and is searched by the file manager search.
  4. Click Save (Запази). You see Successfully renamed the file to "{name}" or Description saved.

AI-created HTML pages (artifacts) must keep their .html extension.

How to move files and folders

  1. Right-click the item and choose Move (Премести), or select several files and click Move ({count}) in the selection bar.
  2. In the dialog Choose a destination folder (Изберете целева папка), find the folder in the tree or search for it.
  3. Click Move here (Премести тук). The message Moved to "{folder}" confirms it. If only part could be moved you see Moved: {moved}, not moved: {failed}.

You can also drag a file or folder onto a folder in the list or in the Folders tree. Drop it on Move to the root level (Премести на главно ниво) to move it to the top level.

How to copy files and folders

  1. Right-click the item and choose Copy to… (Копирай в…), or select several files and click Copy ({count}).
  2. Choose the destination folder and click Copy here (Копирай тук).
  3. The message Copied to "{folder}" confirms it; a partial result shows {copied} copied, {failed} not copied.

A copied folder includes everything inside it that you can read. A copy is a new file with its own history and takes the sharing of the destination folder, not of the original. A copy placed in the same folder gets a distinct name. Copies count against the storage quota. A copy of a 3D/CAD model that was already processed is viewable at once, without new credits.

How to download files

  • One file: right-click it and choose Download (Изтегли). The current version is downloaded.
  • Several files: select their checkboxes and click Download ({count}) in the selection bar. Up to 50 files and 750 MB are packed into one ZIP (Downloaded {count} files as a ZIP). A larger selection shows Selection too large to ZIP — downloading {count} files individually.
  • An older version: open Version History and use the download button of that version. See Versions.

How to select several files

Select the checkbox at the start of each file row in the file manager. Hold Shift and click to select a range. The action bar is replaced by the selection bar.

Selection bar with download, move, copy and delete
Figure: The selection bar after selecting several files.
  1. The counter {count} selected (избрани) shows how many files are selected.
  2. Download (Изтегляне) downloads the selection, as a ZIP when it fits.
  3. Move (Премести) and Copy to… (Копирай в…) open the destination dialog.
  4. Delete (Изтрий) moves the files to the Trash; it appears only if you can delete all of them.
  5. Clear (Изчисти) removes the selection.

On a phone

On a narrow screen the file manager shows compact rows. The folder tree becomes a drawer behind the Folders (Папки) button, and the add actions sit behind the Add (Добави) button. In the selection bar, the actions that do not fit are under More actions (Още действия).

Messages you may see

MessageMeaning and what to do
This folder is empty — Get started by creating a new folder or uploading a file.The folder has no items you can see. Create a folder or upload a file.
You have no uploaded files / No folders or files to showNothing in this file area is yours or shared with you yet.
Folder not foundThe folder was deleted, moved or is not shared with you. Go back to the top level.
You don't have permission to add files to this folder.You need Edit access to the folder; ask its owner to share it with Edit.
A folder with this name already existsChoose another name.
Storage is full. Free up space or upgrade your plan to upload a new version.The company's storage quota is used up. Delete files, upgrade the plan or buy additional storage.
This file type is not supported for preview. Please download it to open it.The browser cannot show this type; download it.
This file cannot be opened. It may be corrupted.The preview failed; download the file and check it, or upload it again.

Common questions

How do I upload many files at once?

In the file manager, click Upload file (Качи файл) and choose several files, or drag them onto the file list. To upload a whole folder tree with its subfolders, click Upload folder (Качи папка) or drag the folder from your computer onto the list.

I uploaded a file with the same name and now I have "Plan (1).pdf". How do I replace the old file instead?

Uploading single files never overwrites; a taken name gets a number. To replace a file and keep its history, open Version History (История на версиите) on the existing file and click Upload New Version (Качване на нова версия). When you upload a whole folder, choose Upload as a new version in the dialog Some files already exist. You can delete the numbered copy afterwards.

Why is the Upload file button not doing anything in this folder?

Inside a subfolder you need Edit access to that folder through sharing, and your role needs File manager Edit. Without it the file manager shows You don't have permission to add files to this folder. Ask the folder's owner to share it with you at Edit (Редакция).

Can my colleagues see the folder I just created?

A folder created at the top level of the file area is private to you until you share it. A folder created inside a shared folder is visible to the same people as its parent. See Sharing, comments and mentions.

Can I copy a folder with everything in it?

Yes. Right-click the folder, choose Copy to… (Копирай в…), pick the destination and click Copy here (Копирай тук). Everything inside that you can read is copied. The copy takes the sharing of the destination folder.

Why does the rename say "Name contains disallowed characters"?

File and folder names in BuildColab cannot contain the sequences script, *, --, ; or /. Replace them, for example use a dot or a space instead of a slash in a date.

Why did my download come as separate files instead of a ZIP?

A ZIP is built for up to 50 files and 750 MB in total. For a larger selection the file manager shows Selection too large to ZIP — downloading {count} files individually. and your browser downloads the files one by one. Select fewer files to get a ZIP.

Where can I see who changed a file last?

Turn on the Updated by (Обновен от) column in the Columns (Колони) menu, or open Details (Детайли) for the file. Version History lists who uploaded each version.