This is an app that runs in the Contentful Editor. If you're looking for a current app that works from Lokalise, please refer to the corresponding article.

Main capabilities of the native app:

To install the app, open Contentful, navigate to Apps, select Marketplace, choose Translation and Localization category, find Lokalise, and then press Install:

Next, select an environment where you want to install the app. Lokalise app could work with any environment and the app could only be installed to one environment:

Select content types that should contain a Lokalise app in the sidebar inside Contentful entry Editor or Compose app and click Install in the top right corner:

Review the default settings and click Save in the top right corner:

The Lokalise section will appear in the sidebar for Entries of content types that you have selected during installation (if it's not there, please refer to the section below)

Click Export content to Lokalise to export the default locale value:

Now proceed to your Lokalise project and open editor. You'll see that the corresponding Lokalise tags have been linked to the inserted keys:

The following tags are added automatically:

The key names are generated using Entry ID and Field ID separated with the : delimiter.

Translations can be imported from the Lokalise sidebar section. You can import one or multiple locales:

You'll see a dialogue with a preview of translations to be imported. Click Import from Lokalise to update translations in Contentful:

The Lokalise app exports the entry where export has been run initially along with all the referenced entries from this page, whether they were references in separate fields or from RichText content.

You can preview what entries will be exported in the export dialog:

Unchecking a referenced entry means that all entries below won't be exported.

All selections are saved per content type, so once you have configured an export you won't need to re-configure it in subsequent exports for the same content types.

Lokalise app follows all linked entries except entries that are separate pages. The app considers an entry a separate page if this page has a field with slug ID:

Fields from the referenced entries would be exported into separate keys and the key name would contain the ID of the referenced entry. A connection between exported and referenced entries is maintained via tags -- referenced entries would have a tag with the title of the exported entry.

Not all fields can be exported to Lokalise. Such fields will be marked with greyed-out checkboxes and you'll see tooltips with explanations. For example, check the ISBN field in the screenshot below:

Here are the main reasons why fields or entries might not be exported to Lokalise:

To enable localization for a field, navigate to the Content model tab, click on the name of the desired item, and then click Edit for a field you want to configure:

Then check the Enable localization of this field setting:

Don't forget to save the changes.

If you are working with custom types and want to connect those to Lokalise, you'll need to perform some additional actions. You can also find more information in the Contentful docs.

First, navigate to the content model:

Click on your content type and proceed to Sidebar:

Add the Lokalise plugin:

Don't forget to save the changes.