Skip to main content
All CollectionsIntegrations
How to set up Contentful integration?
How to set up Contentful integration?
Updated over a week ago

Note: You can connect only one Contentful space to the project.

Lingohub Contentful integration allows seamless CMS content localization to provide a multilingual experience for your customers worldwide. Before integrating Contentful with Lingohub, you must enable content localization inside Contentful.

How to make the Contentful content localizable?

Content models are the foundation of your project, providing structure and organization for all content. They are the basis of creating different content types as they define which fields will be present for a specific page. To localize your content with Lingohub, you should first make the needed fields localizable. Follow the next step, to do this:

  1. Go to "Content model" in the Contentful admin panel. Click on the model you need; for our example, we chose a "Feature page."

  2. Select the field you want to make localizable and click on "Edit."

  3. Select "Enable localization of this field" and click on "Confirm." Save the changes.

    Note: Turning off this field will restrict Lingohub's ability to access the content. It will be filtered out.

How to connect Contentful to Lingohub?

Configure the Contentful workspace plugin to connect Contentful to Lingohub. This action requires creating a "CMA Token" in your Contentful account.

Note: The CMA Token is a user-level token, which means Linghub will only have access to the content available to the user who generated it.

To generate the token, follow the steps below:

  1. Click on the user icon at the top-right corner and choose "Account Settings."

  2. Go to the "CMA tokens" tab and click on "Create personal access token."

  3. Type the token name and choose the expiration day. Click on "Generate."

  4. Copy the personal access token and click on “Done.”

  5. In the Lingohub application, go to “Workspace” – “Plugins and integrations,” find the Contentful plugin in the list (or do a search), and click on “Manage.”

  6. Type the following data into the fields:

    1. Name - name of the authentication

    2. Access token - the token you created and copied.

Excellent — you connected your Contentful account to Lingohub. The next step is to create a Contentful project and set up the Contentful project plugin.

How to set up the Contentful integration?

  1. Create a Contentful project and select the authentication you created in the previous step. Select space and the main environment (you can manage different environments within 1 project). Click on “Create.”

    Remember: the source and target languages will be added automatically based on the Contentful space data. If you need to add a new language to your Contentful project, you can do it later. Read how to add a new language to the Contentful project.

  2. Go to the newly created Contentful project and click on "Plugins" - you will see the Contentful integration. Click on “Manage.”

  3. Inside the Contentful integration, you can check which content was synchronized. You can also set up filters to synchronize the content you want to translate with Lingohub. Read more about resource filers in our Help Center.

  4. If you are satisfied with the list of content, you need to import it to Lingohub. Click on the synchronization icon at the top of the page and choose "Pull."

  5. Select “Import new content” and click on “Update structure.”

    Note: Updating the structure will sync the pages from the Contentful with Lingohub. You should update the structure whenever you change the languages, models, etc., or when the filters have changed.

  6. The import will take some time (generally from a few seconds to a few minutes). Once the import is done/complete, you will see all the content in the Resources tab.

Lingohub Tip: If you can’t find the needed content inside the resources list, check if this content localization is allowed in Contentful and recheck a resource filters.

Now you can start translating your Contentful project.

How to add a new language to the Lingohub Contentful project?

  1. Click on the Settings in the admin panel and choose "Locales."

  2. Click on "Add locale."

  3. Choose a locale. Select “Enable this locale in response” and “Enable editing for this locale.” Save a locale and go to Lingohub.

  4. On Lingohub, click on the synchronization icon at the top of the page and choose “Pull.”

  5. Click on “Update structure.”

  6. Refresh the browser page or click the “Refresh” button to see changes. The language will be successfully added.

Note: you should update the structure every time you need to add new languages, folder, and entries to Lingohub

Awesome! You have finished the article about Contentful integration. If you have any questions - please get in touch with our team via [email protected].

Did this answer your question?