5. How to Manage Translations

Short UI elements—like button labels, menu items, and field names—are handled in Settings > Translations. This section lets you review, edit, and add translations for all “labels” (internal identifiers) used throughout the CRM. Keeping these up to date ensures that every small piece of text in the interface is fully localized.

Why Use Translations?

Consistent UI: Make sure every button or menu item appears correctly in each active language.
Rapid Updates: Quickly fix typos or change wording without redeploying code.
Custom Elements: Add new labels (for custom development) and translate them for your users.

Viewing & Searching Existing Translations

1. Go to ⚙️ Settings → Translations.

2. You’ll see a table with two main columns:

Label: the internal key (e.g., totalLeads).
Text: the currently translated string, along with language badges (En, Bg, etc.).

Editing a Translation

To add a translation of an element:

1. Click the Edit icon on the right of the row you want to update.

2. In the panel that appears:

Label (read-only) shows which key you’re editing.
Languages badges indicate which target languages have entries.
Text field: enter or update the translated string for the selected language.

4. Click Save to apply the changes.

To easily search for elements:

To find a specific item, use the Search field at the top. Typing part of a label filters the list in real time.

~~Note:~~Note: Adding custom elements is intended for development purposes only. The translation object label should be added to the code by developers. Otherwise, if you add a label just with this functionality, it will not be displayed anywhere on the page.

Cloning Translations from an Existing Language

When you’re rolling out a new locale or simply want to copy existing translations as a starting point, use the Clone feature in the translation drawer to pull in all strings from another language at once.

Open the translation drawer

From Settings → Translations, click the ✏️ Edit icon on any row.

The side-panel shows the Label, language badges, and the Text field for your selected language.

Click “Clone translation from”

Under the language badges, click the Clone translation from link.

A small Clone from modal appears, listing all available source languages.

Select a source language

Choose the language whose translations you want to copy (e.g. English → Spanish).

Click Clone. All fields in the drawer will be populated with the source-language text.

Review and adjust

Edit any individual strings that need tweaking for your new locale.

When you’re satisfied, click Save to commit all cloned entries in one go.

Tip: Cloning saves dozens of manual keystrokes when you already have a mature translation in one language and want to bootstrap it in another.

Adding a New Translation

To add a custom element:

1. Click the +Add Translation button in the upper right corner.

2. In the Add translation panel:

Label: enter a unique key (e.g., newButtonLabel).
Languages: check each language you want to provide.
Text: fill in the translation for each selected language.

3. Click Save. The new label now appears in the table, ready to be referenced in code.

Deleting a Translation

1. Click the Delete (trash) icon on the row you wish to remove.

2. Confirm the deletion in the prompt.

You can also delete current items using the Delete icon. It is not recommended to delete items already defined in the system.

Best Practices & Conclusion

Batch your changes: When rolling out a new feature or language, edit multiple translations at once to maintain consistency.
Coordinate with developers: Ensure that any custom labels added here are actually referenced in the codebase.
Review periodically: As UI evolves, legacy labels may become obsolete—clean them up to keep the table manageable.

By centrally managing your short-text translations, you guarantee that every button, tooltip, and menu option in your CRM remains clear, accurate, and localized for all users.