Upload documents / folders
The following article describes how documents and folders can be uploaded to buildagil.
There are different ways to upload individual documents/elements or entire folders.
Directly to the following sections:
Drag & Drop
About upload tab
Synchronize with OneDrive
Troubleshooting during upload
Troubleshooting for shortened file names
Drag the file / folder from your storage location to the desired directory in buildagil with a mouse click.
Select between File or Folder.
Select the file or folder to be uploaded and click Open.
It is possible to synchronize the document library locally on your computer using Microsoft OneDrive. This solution is described in more detail in the following section:
Synchronization OneDrive
If the error message appears when uploading files that the file path or file name is too long, the file is currently locked or there is a connection problem, this can have various causes. The message can also appear if the path from which the file originates is too long.
When uploading files, Microsoft imposes a character limit. If the path (number of characters of the file title + the name of all folders) from which the file originates (e.g. From a local file storage) or the target path in buildagil is longer than 255 characters, the file cannot be uploaded.
In this case, the following solutions can help.
Load and move the file to the top level of the folder structure (versioning is not guaranteed this way)
Move the file to be replaced to a higher folder structure, then overwrite it with the new file and then move it back again
Upload file from desktop
Make folder structures flatter (less deep folders and less long names)
The extended folder name can be activated in the project settings so that the length of the folder names can be optimized.
You can find detailed information on the extended folder designation in the following article: Extended folder designation
If a file is saved as a copy or in another file format (e.g. PDF) via an app (such as Excel, Word, etc.) with "Save as", the file names may be shortened automatically. This happens if the entire path, i.e. The storage location including the file name, is longer than 255 characters. This limitation is a system-related restriction by Microsoft.
Behavior
If the maximum path length of 255 characters is exceeded, the file cannot be saved as expected. Instead, the following may happen:
The file is saved in a folder further up in the structure that is still within the 255-character limit
The file name is shortened so that it complies with the character limit together with the path
Solutions
First save the file in a folder that is less deep in the folder structure. The file can then be moved to the desired storage location
Check whether the folder structure can be simplified to shorten the path
Use shorter file names
There are different ways to upload individual documents/elements or entire folders.
Directly to the following sections:
Drag & Drop
About upload tab
Synchronize with OneDrive
Troubleshooting during upload
Troubleshooting for shortened file names
Drag & Drop
Drag the file / folder from your storage location to the desired directory in buildagil with a mouse click.
About upload tab
Select between File or Folder.
Select the file or folder to be uploaded and click Open.
Synchronize with OneDrive
It is possible to synchronize the document library locally on your computer using Microsoft OneDrive. This solution is described in more detail in the following section:
Synchronization OneDrive
Troubleshooting during upload
If the error message appears when uploading files that the file path or file name is too long, the file is currently locked or there is a connection problem, this can have various causes. The message can also appear if the path from which the file originates is too long.
When uploading files, Microsoft imposes a character limit. If the path (number of characters of the file title + the name of all folders) from which the file originates (e.g. From a local file storage) or the target path in buildagil is longer than 255 characters, the file cannot be uploaded.
In this case, the following solutions can help.
Load and move the file to the top level of the folder structure (versioning is not guaranteed this way)
Move the file to be replaced to a higher folder structure, then overwrite it with the new file and then move it back again
Upload file from desktop
Make folder structures flatter (less deep folders and less long names)
The extended folder name can be activated in the project settings so that the length of the folder names can be optimized.
You can find detailed information on the extended folder designation in the following article: Extended folder designation
Troubleshooting for shortened file names
If a file is saved as a copy or in another file format (e.g. PDF) via an app (such as Excel, Word, etc.) with "Save as", the file names may be shortened automatically. This happens if the entire path, i.e. The storage location including the file name, is longer than 255 characters. This limitation is a system-related restriction by Microsoft.
Behavior
If the maximum path length of 255 characters is exceeded, the file cannot be saved as expected. Instead, the following may happen:
The file is saved in a folder further up in the structure that is still within the 255-character limit
The file name is shortened so that it complies with the character limit together with the path
Solutions
First save the file in a folder that is less deep in the folder structure. The file can then be moved to the desired storage location
Check whether the folder structure can be simplified to shorten the path
Use shorter file names
Updated on: 09/01/2025