Not all languages supported by Localazy are supported by Strapi. Keep in mind that downloading an unsupported locale to Strapi will result in a warning. Supported languages will still be downloaded.
You don’t need to create a locale in Strapi first. It will be created automatically while downloading (if the locale is supported by Strapi).
Download to Strapi #️⃣
Navigate to the Download to Strapi screen in the plugin.
Select languages to Download option allows to download only selected languages. The selection is automatically saved when a value is selected. If none of the languages are selected, all the available languages in the connected Localazy project will be downloaded.
This does not configure the webhooks languages to download. If you’d like to do that instead, go to Global Settings - Download Settings.
Download changes (incremental) — Downloads only translations that have changed since the last sync. This is significantly faster for large projects. This button is disabled until at least one Full Sync has been completed.
Full Sync! — Downloads all translations from scratch. Use this for the first sync or when you want to force a complete re-download. A confirmation dialog warns that this may take significant time for large projects.
Values that are not downloaded from Localazy when there are newly created localized entries that have a default value set will also be set to the default value.
It’s sometimes necessary to click the Start Download button twice when the relations linking process takes place when creating the entries - this is because localized relations might not have been created yet.
When updating the order of translatable repeatable components in the default entry: If you want to achieve the same order in translated entries, delete the field content (with the repeatable component) and click Start download again. The content will be re-created in the correct order.
The download report includes the following:
- Overall download result,
- created locale,
- not supported locale,
- created entry in a certain language,
- updated entry in a certain language.
When a download encounters errors (e.g., validation failures in Strapi), the report now shows:
- The specific error message (e.g., “description must be at most 80 characters”)
- A clickable “Open in Strapi” link to the affected entry
- A clickable “View in Localazy” link to search for the key in your Localazy project
Failed entries are automatically retried on the next download.
Remember, download is not enabled in case of Content Types Model changes or incompatible languages. Make sure to keep the Content Transfer Setup up to date.
Any download error which is not conveniently described in the user interface, can be found in Strapi server logs.
Incremental Sync #️⃣
How Incremental Sync Works #️⃣
The plugin tracks which translations have been successfully downloaded per language and per key. On subsequent downloads using Download changes:
- Only keys with newer translations are processed
- Already-downloaded translations are skipped
- Progress is saved after each entry — if the download is interrupted (crash, timeout, manual stop), the next run resumes from where it left off without re-processing completed entries
This is especially useful for large projects with thousands of entries where a full sync can take hours.
First sync: You must run a Full Sync first. The “Download changes” button is disabled until at least one sync has been completed.
After a Full Sync: The Download changes button becomes available immediately (no page reload needed).