Skip to content

Translations

Translations

One content type, different text translations.

Introduced in version 1.1.0, this feature allows you to quickly handle translations for your content. This feature was introduced at the same time with Hyvä AI features to aid in translating content in different languages.

Features

The translation panel provides a complete workflow for managing content translations:

  • Export translations to CSV
  • Import translated CSV files back into the editor
  • Manual translation entry per store view
  • Drag-and-drop CSV import support
  • Translation status tracking

AI-Assisted Translations (Separate Package)

The Hyva_CmsAiTranslations package adds optional AI-powered translation assistance:

  • Supports multiple AI providers: OpenAI, Google Gemini, and DeepL
  • Batch translation processing for efficiency
  • "Translate Empty Fields Only" vs "Replace All" modes
  • Field size and count limitations for safety

Developer Guide

You can add support for translations to your own components by adding "translate": true to the component declaration.

{
  "example": {
    "label": "My Component",
    ...
    "content": {
      "title": {
        "type": "text",
        "label": "Title",
        ...
        "translate": true
      },
      ...
    },
  }
}

Usage Guide

Ensure this is enabled in Stores > Configuration > Hyva Themes > CMS > Editor Settings > Enable Translations

This is enabled by default.

This can be accessed 2 ways:

  • From the top left Hyvä Commerce logo, click the translations option in the dropdown menu.
  • From component fields directly, click the translations icon.