How to set up the Akeneo Integration

Let’s dive right in.

Open your Akeneo workspace. Proceed to the Connections settings in your Akeneo workspace.

Create connection by clicking on the respective button. Enter the label and the code and save your connection.

On the page that opens, you can see the data which we will use for Smartcat. Save all of the data that Akeneo provided under the Credential field.

Next important step is to specify a list of locales to be used for translation. To add more locales to your project, navigate to the Settings, then open the Channel settings.

Specify new locales in the Locales field.

Another important thing is to make sure that the attributes that are used in our project are localizable.

To make your attributes localizable, we need to toggle on the Value per local switcher when creating new attributes.

Now we are ready to set up the Akeneo integration inside the Smartcat platform.

Open your Smartcat workspace and select the Set up an integration shortcut.

Select the Akeneo integration from the list.

Fill in the required data fields.

Locate the API URL in your Akeneo workspace by checking the browser’s address bar.

For the remaining fields, use the previously saved data: the Client ID, Client Secret, Username, and User Password. Proceed to the next screen by clicking the Create Integration button.

On the next screen, select the default (source) locale for your Akeneo project and choose the channel to be used in Akeneo. Then, connect your Smartcat workspace to Akeneo by clicking the Create Integration button again to complete the process.

An integration page will open, allowing you to view the hierarchy of your folders, as well as the categories and attributes within your project.

If you can't find your product in Smartcat, this means that you haven't added it to any category. Let's fix that.

Open your product in Akeneo, then navigate to Categories settings.

Select the category for your product and click Save. As you can see in the notification below, the product was successfully updated.

Go back to Smartcat, and by using the refresh button, synchronize the changes that we made with our product. If everything was done correctly, you'll see that your product appears under the specific category.

Now everything is ready for translation. Under the name of your product, select on the source language. In the context menu above, press the Create translation button.

Select if you want to create a new project for your translation or you can add your translation to the existing project in Smartcat.

Populate the required fields such as name, the source language, and the target language(s). You can select multiple target languages if you want to translate into more than one.

You also need to choose a workflow for your translation. For this task, we'll use the Automatic Translation → Post-Editing workflow. Smartcat will select the most suitable AI engine for the initial translation. After that, you can review the translation yourself or invite a collaborator to your project in Smartcat.

Proceed to the Integration-specific settings by clicking the respective button below.

Import mode: select if you want to import an existing translation if there are any.

Attributes: choose the attributes for translation.

Click the Create project button. After the process is done, you’ll see new target languages with progress bars under the name of your product. On the right, you can see the name of the associated Smartcat project.

To open your translation in Smartcat Editor, click on the underlined name of the associated Smartcat project to the left of the target language.

The Overview tab will open. When the progress bar reaches 100%, the AI translation workflow stage is completed. Let’s open your file in the Smartcat Editor.

Proceed to the Files tab. Open your file by clicking on the source language.

The editing area is divided into segments. Edit your translation as needed.

Check the Quality Assurance tab for inaccuracies if there are any.

Access the history of changes by navigating to the History tab.

Review your translation by going through it segment by segment.

Alternatively, you can also confirm all segments at once by clicking the green button in the toolbar above, on the left.

When you're done reviewing your translation in Smartcat Editor, click the Done button. This will finalize the review stage.

Another way to review your translation is to assign this task to a human reviewer. Navigate to the Tasks tab.

Select the Post-editing task, and then click the Invite button.

Choose the most suitable option for you: invite a human reviewer from your team, agencies, or from the marketplace. Alternatively, you can invite a human reviewer to the Smartcat workspace using an email or link. Specify the role of the human reviewer and the rate in the Additional Options section.

Click the Send Invitations button. Track your invitation status in the Tasks page.

After the translation review stage is complete, it’s time to send this translation to Akeneo. First, let's refresh the status of our project. Use the Refresh button.

Wait for the progress bar to update.

Select the translations that you want to send. You can choose multiple translations. Then, press the Send to Akeneo button.

Specify the completion mode of your translation.

You can send the translation with unconfirmed edits if you haven't finished working on it. Once the synchronization is complete, you can return to your Akeneo workspace. Open your project and select the desired locale.

As you can see, our content was successfully translated, and you can review the translation in Akeneo.