Customizing interface text

In Haiilo, language keys refer to pre-defined system/interface text like "What are you working on?" or "X has shared this post with [...]". You can customize these keys to align with your company's terminology, phrases, and branding, creating a platform that's tailored to your needs.

interface translation example.png

Identify a language key

In the platform, each item, button, or element has a unique language key. As there are numerous keys in Haiilo, it's not possible to list them all here. However, here are some tips to help you identify the language key for a specific element, which will enable you to locate it in the settings.

  • You can search by the default translation. Since you know the default translation of a language key since it's visible in the platform, you can search by this to find the correct language key. This is particularly useful if you want to edit a longer text, e.g., "What are you working on?" as it is less likely that there are many language keys for this input.
  • You can search for a related element. Language key names often contain the element names to which they relate. This can help you narrow down the list of matching language keys. For example:
    • If you want to edit the language keys for the navigation bar items (Pages, Communities, Events, etc.), these contain the keyword navigation.
    • If you want to edit the language keys for an item found in the Administration, these contain the keyword admin. You can further narrow down to, e.g., user management items by adding user_mgmt to the search term, i.e., admin.user_mgmt.
    • If you want to edit the language keys for an item found in an email from Haiilo, these contain the keyword email. You can further narrow down to, e.g., email notification items by adding email_notification to the search term, i.e., email.email_notification.

Add a custom translation

  1. Go to Administration > Languages > Interface translations
  2. Select the language for which you want to edit a language key. You will need to change a key for each of your platform's languages separately.
  3. In the list, you can see for each row:
    • Key: The name of the language key. This shows where the system text is located.
    • Translation: The default translation. If nothing is filled in the Override field, this translation is currently active in the platform.
    • Override: The custom translation provided by you, if filled. Initially, this field shows an Edit placeholder. If you provide a custom translation, it will override the default translation.
  4. Search for the language key that you want to edit. You can search with keywords located in the language key name or in the default translation.
  5. When you find the key you want to edit, select the Edit placeholder in the Override column for that key
  6. Enter your custom translation
  7. Press Enter on your keyboard to save your custom language key

It can take a while for the new translation to update on the platform.

The terms for the Haiilo mobile app must be adapted separately. You can view the mobile app language keys by checking the Mobile box. It may take up to 24 hours until the changed language keys are updated in the Haiilo mobile app. To shorten this time, users can reinstall the app on iOS devices, and clear the cache on Android devices.

Remove a custom translation

If you want to, you can revert back to the default translation.

  1. Go to Administration > Languages > Interface translations
  2. Select the language for which you want to edit a language key.
  3. Either search for the language key that you want to edit or check the Override box to see only the language keys for which you've added custom translations.
  4. When you find the key you want to edit, select the custom translation in the Override column for that key
  5. Remove your custom translation
  6. Press Enter on your keyboard to save

Alternatively, if you want to start fresh with the default translations and remove your custom ones, you can select Reset current language.

Was this article helpful?