Viewing and editing documents

Which files open where

Quick preview

Quick preview shows a file in a window over the file manager, so you do not lose your place in the folder. Click an image to open it in quick preview, or right-click any previewable file and choose Quick preview (Бърз преглед). If the file is damaged you see This file cannot be opened. It may be corrupted.

The editor page

When you click a Word, Excel, PDF, Markdown, text or CSV file in the file manager, the editor opens on its own page.

1. The Files (Файлове) button returns to the folder the file is in.
2. The file name and the number of the version you are looking at.
3. The panel tabs Comments (Коментари), History (История) and Details (Детайли) open a side panel with the discussion, the versions and the file information.
4. Discard changes (Отхвърли промените) throws away your unsaved edits.
5. Save (Запази) stores your edits as a new version; it is active only when there is something to save.
6. The document area where you edit.

How to edit and save a document

1. In the file manager, click the file. The editor opens.
2. Make your changes.
3. Click Save (Запази). The message The document has been saved as a new version. confirms it. The previous content stays in the version history.
4. Click Files (Файлове) to go back to the folder.

Everyone with access to the file gets a notification about the new version. If you leave the page with unsaved edits, the dialog Unsaved changes (Незапазени промени) asks You have unsaved changes. Are you sure you want to leave? Click Stay (Остани) to keep editing or Leave without saving (Напусни без запазване) to drop them.

When two people edit the same document

BuildColab does not lock a document while someone edits it. If a colleague saves a newer version while you still have the document open, the editor shows the banner A newer version (v{n}) was saved by {name}. You have two choices:

• Reload (Презареди) loads the colleague's version. If you have unsaved edits, the button reads Reload (discard my changes) (Презареди (без моите промени)) and your edits are lost.
• Save mine as newest anyway (Запази моята като най-нова) asks Save your version as the newest? with the explanation The other version (v{n}) stays in the version history, and yours becomes the newest one. Click Save as newest (Запази като най-нова) to confirm.

Nothing is ever lost: whichever you choose, both versions remain in the version history. The plain Save button is disabled while the banner is shown, so you never save over a newer version by accident.

When the editor opens read-only

The editor opens in read-only mode, with the note You are viewing the document in read-only mode. (Преглеждате документа в режим само за четене.), in these cases:

• You have Read (Четене) or Comment (Коментиране) access to the file, but not Edit (Редакция).
• You are viewing an older version from the History panel. To edit it, restore it as current first; see Versions.
• The text file's character encoding could not be recognized: The file's text encoding couldn't be recognised, so it opens read-only to keep it intact.

Limits and messages in the editor

Text, Markdown and CSV files

Markdown (.md), text (.txt) and CSV (.csv) files open in the BuildColab text editor. A Markdown file has two modes, switched by Editor mode (Режим на редактора): Edit (Редакция) for the source text and Preview (Преглед) for the formatted result, including Mermaid diagrams. An empty file shows Nothing to preview yet. in preview.

The editor shows the file's character encoding as Encoding: {name} (Кодиране: {name}). Old Bulgarian files are often in Windows-1251. If you type characters that Windows-1251 cannot hold, the editor lists them (These characters can't be saved in Windows-1251: {chars}) and offers Save as UTF-8 instead (Запиши като UTF-8). Until you choose it, saving is refused with Not saved: some characters can't be written in Windows-1251. Choose "Save as UTF-8" in the editor.

Company letterheads (Letterheads tab)

The Letterheads (Шапки) tab exists only in the company file area. Its title is Company letterheads (Фирмени шапки). A letterhead is an Excel (.xlsx) header template with your company's logo, details and layout. When you export a bill of quantities (BoQ), the export wizard puts the BoQ under the chosen letterhead, and the default letterhead is preselected. See Exporting.

How to add a letterhead

1. Open company sidebar → Files (Файлове) → tab Letterheads (Шапки).
2. Click Upload template (Качи шаблон) and choose an .xlsx file, or click Create blank (Създай празен) to start from an empty template named "New template" (Нов шаблон).
3. Click the template to open it in the spreadsheet editor. The Placeholder tokens (Заместващи полета) tab lists the fields you can place in the header, such as project or BoQ details, which the export fills in.
4. Click Save (Запази).
5. In the template's menu choose Set as default (Задай по подразбиране). The template gets the badge Default (По подразбиране).

The template menu also has Open (Отвори), Download (Изтегли), Rename (Преименувай) and Delete (Изтрий), which asks Are you sure you want to delete this template? Only .xlsx files are accepted (Only .xlsx templates are supported.), and two templates cannot share a name (A template with this name already exists.). Managing letterheads needs File manager Edit (Редакция) at company level; with View you can open and download them only.

Project BoQ documents (BoQ documents tab)

The BoQ documents (КСС документи) tab exists only in a project's file manager. It collects the files that belong to the project's bills of quantities, which do not appear in the ordinary folder tree:

• the panel BoQ lists (КСС листове) on the left, where you pick a BoQ;
• Bid sources (Първоизточници): the original Excel workbook a BoQ was imported from (see Importing a BoQ from Excel);
• Exports (Експорти): every export generated from that BoQ, newest first (see Exporting);
• Other files (Други файлове) that belong to the BoQ.

Each document has Open (Отвори) for editable types and Download (Изтегли). The document's owner also has Share (Споделяне) and Delete (Изтрий); delete asks Are you sure you want to delete this document? When the tab is empty it says Imported bid workbooks and the exports generated from them will appear here.

1. The BoQ documents (КСС документи) tab.
2. The BoQ lists (КСС листове) panel, where you choose a BoQ.
3. The Bid sources (Първоизточници) section with the imported workbook.

Common questions

Related

• Folders, uploading and navigation
• Versions
• Sharing, comments and mentions
• Exporting
• AI features: search, artifacts, diagrams