Import copy components from file

Frontitude lets you import product copy from the code, localization tools, or other external sources, straight into your copy library. Using this feature, you can upload your UX content to Frontitude and store it in a single source of truth.

‍

Supported file types

The import feature currently supports the following file formats:

CSV

Supported CSV filed for import should contain the following columns:

• Unique key - The copy component's unique key
• Value - Text's actual source-language text value
• Value (<locale>) - A separate column for each configured target language, including the locale identifier (LCID). Only those languages defined in your workspace as target languages will be considered

💡 Tip: The best way to import copy components from a CSV file is to first export your library to a CSV file, then use this file for the import process.

💡 Important: Only those languages defined in your workspace as target languages will be considered

‍

Download a sample CSV file to learn about the supported format.

‍

JSON - Flat

{
  "info_tooltip_title": "No worries, you won’t be charged",
  "info_tooltip_paragraph": "You can review this order before it's final"
}

‍

JSON - Nested

{
  "info_tooltip": {
    "title": "No worries, you won’t be charged",
    "paragraph": "You can review this order before it's final"
  }
}

💡 In nested JSON structure, all non-leaf keys (keys that point to an object and not a string) will be converted into categories, to make the import better organized.

‍

How to import copy components from file

Once you have a file that includes content, either generated by developers from the codebase or exported from Frontitude or other tools, you can import it to the library by following the next steps:

‍

1. Open you Copy Library.
2. On the top of the screen, click on the Options menu (three dots), and choose Import from file.‍
3. You can either click on browse or simply drag and drop a supported file into the droppable area.
4. Once the file is processed, the number of valid entries detected will be displayed.
5. Check the Override values of existing copy components checkbox to update existing components with the imported content. Keeping it off ensures that existing component will remain unchanged.
6. Click Import to start the import process. Once finished, you'll see the number of components created and updated. Notice that this process can take a while for large files.
7. The imported copy will be stored as "Uncategorized" and wait for you to be categorized.
8. Follow this guide to learn how to build and maintain an organized copy library.

‍

Import translations from a CSV file

To import or update translations from a CSV file, ensure the following:

• Your CSV file has separate column for every language, named in the following format: Value (<Language Name> - <Locale>).
  • Example: Value (Portuguese - pt_BR), Value (French - fr_CA), Value (Polish- pl)
• The languages included in the CSV file are configured as target languages in your Frontitude workspace.
• The Override values of existing copy components flag is checked.

‍

Import translations from a JSON file

Copy library import supports files in flat format only. If the file is exported from Frontitude, make sure that you have unchecked the Include metadata option.

1. Open you Copy Library.
2. On the top of the screen, next to Add components click on the Options menu (three dots), and choose Import from file.
3. You can either click on browse or simply drag and drop and JSON file into the droppable area.
4. Once the file upload has been completed, Frontitude will notify the number of valid entries that have been detected in the file.
5. Click Import to start the import process. Once it’s finished, you’ll get the number of translations created. Notice that this process can take a while for large files.

‍

💡 Translations are created only for existing copy components. If no component found for a key, the translation will be skipped.

‍

‍

Next steps

Once you're done importing your content as copy components, you can invite other members of your team, manage all your UX content in one place, sync the it with the design and code, and localize it with Frontitude.

‍