Downloading to Localazy #️⃣

Download controls are located in the Download to Localazy tab. Click Download All Stories To Localazy to start transferring the stories.

Storyblok - Download to Localazy Tab

Integration connects to the Storyblok Management API. Then, based on the Settings setup, it takes either the source language (Storyblok defines it as Default language) stories or all stories (in all languages defined in the Internationalization Settings) in the Storyblok space.

Integration then iterates over the stories. When all the stories are iterated over, a batch transfer to Localazy is initiated.

Fields handling #️⃣

Storyblok RichText field #️⃣

Storyblok interprets Rich Text fields as JSON. That means that if such a structure is transferred to any Translation Management System, it would be hard to translate as a user would see a JSON structure to be translated.

Localazy provides a way to overcome such issues by 1:1 converting the JSON to HTML during the download. This way, the field content is user-friendly and can be translated easily.

If the conversion fails (it rarely happens due to an invalid JSON structure coming from Storyblok API), then the original field value is transferred to Localazy.

Storyblok Table Field #️⃣

Table fields are already well-handled by Storyblok export/import endpoints Localazy uses. Every cell of a table is exported as a separate key.

During the import, Storyblok handles the whole process.

Report #️⃣

The progress bar is useful for transferring a higher number of content fields. Due to Storyblok Management API limits, there are short breaks between requests.

When having hundreds and hundreds of stories, the transfer can take tens of minutes to finish and the progress bar is a handy way to check if the transfer is still in progress.

Info reporting #️⃣

In the Info report, you are informed about every story that was processed from the Storyblok.

Listed data:

  • timestamp - current time
  • storyId - processed story id
  • langCode - processed story’s language code

As mentioned earlier, transfer to Localazy happens after all the stories have been processed.

Error reporting #️⃣

In any error happens during the Download to Localazy process, a user is informed about it in the Error report.

Listed data:

  • timestamp - current time
  • storyId - processed story id
  • fullslug - processed story’s language code
  • fieldKey - the exact field of the story when an error occured
  • the exact error message

When contacting Localazy on the customer support, please send us your error report so we have an additional information about what happened.