Translation Profiles

Translation profiles allow you to define which product attributes should be translated for specific groups of products, helping you optimize translation costs and workflows.

Default for New Instances: Translation Profiles are automatically enabled for all newly connected Akeneo instances. Existing instances can migrate from the legacy attribute filter to Translation Profiles through the settings page.

Overview

With translation profiles you can:

  • Reduce costs by translating only relevant attributes per product type
  • Create targeted configurations for different product categories
  • Apply profiles to individual products or bulk assign them

How It Works

When a product has a translation profile assigned, only the attributes included in that profile will be translated. Products without a profile use the default profile.

The profile is selected using the Translation Profile attribute that gets added to your products in Akeneo.

Setup Wizard

The profile management feature includes a setup wizard that guides you through:

  1. Create Attribute - Automatically creates the translator_profile attribute in Akeneo (if it doesn't exist)
  2. Assign to Families - Add the attribute to product families where you want to use profiles
  3. Ensure up-to-date options - Ensure that the options available in the attribute match the created profiles.
  4. Set Default - Choose which profile should be the default

The wizard handles all the technical setup automatically, including creating the attribute and configuring it properly in your Akeneo instance.

profiles-setup-wizard.png

Managing Profiles

translation-profiles.png

Create a Profile

  1. Go to Settings > Translation Profiles
  2. Click Create Profile
  3. Enter a name (e.g., "Technical Attributes")
  4. Select which attributes to include
  5. Click Save

Edit or Delete Profiles

  • Click on any profile to edit its name or attribute selection
  • Use the delete button to remove profiles (products will fall back to the default)

translation-profile-edit.png

Set Default Profile

One profile must always be marked as default. This is used for products where not profile was selected.

Common Use Cases

Technical Documentation

  • Include: Specifications, features, materials
  • Exclude: Marketing content

Marketing Content

  • Include: Description, benefits, SEO text
  • Exclude: Technical specifications

Basic Information

  • Include: Name, short description only

Troubleshooting

Profile attribute not visible?

  • Run the setup wizard to create and assign the attribute
  • Check that the attribute is assigned to your product family

Attributes not translating?

  • Verify they're included in the active profile
  • Check they're marked as localizable in Akeneo
  • Ensure source content exists

Related Documentation