Update a Project
Overview
After a project has started, you may need to add new files or update existing files with revised content. Smartcat provides built-in features to handle both scenarios while preserving your translation work.
When you upload a file with the same name as an existing document, Smartcat gives you the option to either update the existing document (replacing it while preserving translations) or upload it as a new document.
Prerequisites
-
Active Smartcat workspace with an existing project
-
Workspace admin or project manager permissions
-
Files to upload (new or updated versions)
⚠️ For the Update option to appear, file names must match exactly with existing files in the project. Even small differences (extra spaces, different characters, or additional text) cause the system to treat the upload as a new file.
How it works
Adding or updating files in a project
Step 1 — Access the upload menu
-
Open your project in Smartcat
-
Go to the Files tab
-
Click the down arrow next to the Upload button
-
Select one of the following options:
-
Upload documents: Add new source files or update existing ones
-
Add reference files: Upload reference materials for translators
-
Update translation: Upload bilingual XLIFF files to update translations
-
Step 2 — Select your files
-
Select the files you want to add to the project
-
If uploading new documents, confirm the project information (source and target languages)
-
Configure format-specific options as needed
Step 3 — Choose how to handle duplicate files
If you upload a file with the same name as an existing document, Smartcat prompts you to choose:
Update current document
-
The existing document is replaced by the new version
-
All translation work is automatically transferred to the new file (extracted from the translation memory)
-
No translation work is lost
-
Task assignments are canceled — you need to reassign tasks to linguists
-
Some formats (PO/Serge, XML) support updating segments by ID without canceling assignments
Create new document
-
The file is added as a separate document
-
A number is added to the file name to distinguish it from the existing file
-
The document is processed using the project's linguistic assets
Step 4 — Configure segmentation options (for updates)
When updating a document, you can configure how Smartcat handles segmentation:
-
Click into each uploaded file individually
-
Under Segmentation mode, select one of the following:
-
Like the source file: Preserves the original file's segmentation
-
Additionally segment untranslated units: Applies Smartcat's segmentation rules to untranslated segments only
-
⚠️ The Additionally segment untranslated units option must be selected individually for each file during the update process. This setting does not apply globally across all files in the upload.
Step 5 — Complete the upload
-
Review your settings for each file
-
Click Finish to process the upload
-
The documents are added to the project and processed using the project's linguistic assets
Troubleshooting: Update option not appearing
If the Update option does not appear when uploading files, the file names do not match exactly.
Solution A: Rename your local files
Rename your local files to match exactly what appears in Smartcat, including any additional text (such as "(Improved Segmentation)")
Solution B: Rename files in Smartcat
-
In Smartcat, rename the existing file to remove any extra text
-
Upload your original file with the matching name
-
The Update option should now appear
Adding a new target language to an existing project
You can add additional target languages to a project at any time, even after files have been uploaded.
Step 1 — Open project settings
-
Go to Project overview
-
Click the Settings icon (cog)
Step 2 — Add the new language
-
Under Target Languages, add the new language
-
Click Set up MT and select the appropriate machine translation engine for your content type
-
Enable Apply new languages to all documents upon save to apply the new language to existing files
Step 3 — Save changes
Click Save to apply the changes.
📌 If you skip the Apply new languages to all documents upon save option, the new language only applies to files uploaded after the change.
Combining Smartcat projects
If you have related work split across multiple projects and want to consolidate it into one, you can do this manually by re-uploading the files from one project into the other.
How to use it
-
Decide which project you want to keep as the consolidated project, and open it
-
Go to the Files tab
-
Click the down arrow next to the Upload button and select Upload documents
-
Select the source files from the other project(s) that you want to bring in
-
If a file you're uploading has the exact same name as a file already in the project, Smartcat prompts you to choose:
-
Update current document — replaces the existing document; translation memory automatically fills in matching work, but task assignments are canceled and must be reassigned
-
Create new document — adds the file as a separate document (Smartcat appends a number to the file name) so nothing in the target project is overwritten
-
For any text not already covered by a translation memory match, Smartcat applies AI translation again, which consumes Smartwords
-
Click Finish to complete the upload
The files from the other project are now available in your consolidated project. Review document and segment status to confirm everything transferred before taking any further action on the original project.
Limitations and known constraints
-
The update feature does not work with all file types. Notably, .docx files cannot use this feature.
-
Task assignments are canceled when using the Update option (except for certain formats like PO/Serge and XML that support segment ID matching).
-
Both Update and Upload actions consume Smartwords for retranslation.
FAQ
Q: Why doesn't the Update option appear when I upload my file?
A: File names must match exactly. Check for differences like extra spaces, different characters, or additional text (such as "(Improved Segmentation)"). Rename either your local file or the file in Smartcat to match exactly.
Q: Do I need to apply the "Additionally segment untranslated units" option to each file?
A: Yes. This setting must be selected individually for each file during the update process. It does not apply globally across all files in the upload.
Q: Will I lose my translation work if I update a document?
A: No. When you update a document, all translation work is automatically transferred to the new file through the translation memory. However, task assignments are canceled, so you need to reassign tasks to linguists.
Want to learn more?
See how Smartcat can transform your localization workflow.
Still need help?
Our support team responds within one business day.