This app is in beta.

Typeform makes collecting and sharing information comfortable and conversational. It's a web based platform you can use to create anything from surveys to interactive apps, without needing to write a single line of code.

Index

Installation

Open your Lokalise project, proceed to Apps and find Typeform in the list:

Click on it and press Install.

You will see the following screen:

In order to proceed with the setup, you will have to provide your Typeform personal token.

Getting a Typeform personal token

Proceed to Typeform and log into the system. Find your name in the top left corner, click on it, and choose Account:

Proceed to Personal tokens and click Generate a new token:

You'll be presented with the following dialog box:

Give your token a name, choose Custom scopes and make sure to enable at least the following scopes:

  • Accounts — read

  • Forms — read, write

Click Generate token and copy it. Please note that you won't be able to view this token once you close the dialog.

Next, return to Lokalise and paste your token to the corresponding field. Finally, click Authorize to complete the installation process.

Importing items from Typeform to Lokalise

Once you've installed the app, you'll be presented with the list of forms that are published in Typeform; you might need to click Refresh if the forms is not listed automatically after a few seconds.

  • The form title.

  • The different fields for each numbered question, which might include a description, options for multiselect fields, and any other text.

  • The form ending (last screen) title and description.

On the Available for import view, select the items that you would like to import, and then click on Import to Lokalise. Each individual field will result in a separate key on the editor.

Choose the language of the original content you're going to import:

Tick the Overwrite existing keys option if you want to update existing translation keys with any updates that happened on the Typeform content since the last import. Updated keys will return to the Unverified status.

Once you are ready, click OK.

Importing will happen in the background, and once the operation is completed, you'll see the following notification:

The imported content will move to the Translation in progress view.

Now you can return to the Editor and perform the translations as usual.

Exporting items from Lokalise to Typeform

Once the translations are reviewed on the Editor, return to the Typeform app on Lokalise, and switch to the Translation in progress tab. Choose one or more items and click Export to Typeform:

You'll be presented with the following dialog:

Choose the languages that you want to export and hit OK. The operation will be performed in the background, and you'll be notified once it is completed.

All the exported items can be found under the Translation exported tab:

Now you can return to Typeform and check that your translated content was properly exported. Typeform supports a single language per form, therefore Lokalise will create a form duplicate for each different language. For example, initially we had a single form in English, and then used to Lokalise to translate it into Catalan. Therefore as a result we have two forms now:

Note on reviewed translations

As you mark your translations as reviewed on Lokalise, its status will change under the Translation in progress tab. For example, if your project has three languages and you've reviewed translation for one language only, you'll see 1 of 3 languages translated status.

Once you have reviewed translations for all languages, the global status for the given item will change to Ready for export.

You can choose the languages to show progress for in the corresponding dropdown:

You can export any items even if their global status is not Ready for export.

Known issues

  • Currently, you can’t reimport items from Typeform that were already translated and exported from Lokalise. As a workaround, you can delete the translated versions of the form on Typeform, and restart the process again.

Did this answer your question?