Translation Management
Working with translations, editing values, and managing translation history
Translation Management
This guide covers everything you need to know about working with translations in MovaBase, from viewing and editing to managing history and collaborating with your team.
Translation Interface Overview
The translation interface is where you will spend most of your time in MovaBase. It is designed to provide efficient access to all your translations while keeping the interface clean and organized.
Interface Layout
When you open the Translations tab, you will see a well-organized interface with these components:
| Component | Purpose | Location |
|---|---|---|
| Translation Table | Main editor for viewing and editing translations | Center of the page |
| Language Columns | Side-by-side view of all configured languages | Right side of the table |
| Search Bar | Find specific translations quickly | Top of the table |
| Filter Controls | Filter by language or file | Below search bar |
| Sidebar | Languages, files, download/upload options | Left side of the page |
The translation interface automatically updates to show real-time changes from other team members and your own edits.
NEEDS_MEDIA
Viewing Translations
Understanding how to navigate and view translations efficiently will help you work faster and more effectively.
Scanning Through Translations
MovaBase displays all your translations in a table format that makes scanning through your content easy:
| Feature | Description | How to Use |
|---|---|---|
| Table Rows | Each row represents one translation key | Scan vertically through keys |
| Language Columns | Each column shows values for a specific language | Compare translations across languages side-by-side |
| Tree View | Hierarchical display of nested keys | Navigate through grouped translations |
| Scroll Navigation | Smooth scrolling through large translation sets | Use mouse wheel or trackpad |
Understanding Translation Rows
Each row in the translation table contains important information about that translation key:
| Element | Description | Location |
|---|---|---|
| Key | The translation identifier used in your code | Leftmost column |
| File Indicator | Which file this translation belongs to | Small icon or badge near key |
| Language Values | The translated text for each configured language | Cells in the row |
| Status Indicators | Shows if value is edited, empty, or linked | Small icons or badges |
| Collaboration Badges | Shows which team members are viewing or editing | Presence indicators |
Key Visualization
MovaBase provides visual cues to help you quickly identify translation states:
Language Column Layout
Language columns are displayed from left to right based on the order of languages in your project:
| Column Type | Description | Use Case |
|---|---|---|
| First Column | Usually your default or source language | Reference for new translations |
| Target Languages | Languages you are translating into | Compare against source |
| All Configured Languages | Every language added to your project | View complete translation coverage |
You can reorder language columns by managing the language order in your project settings. This helps you group related languages together or prioritize your most important target markets.
Editing Translations
MovaBase makes editing translations quick and intuitive with automatic saving and conflict prevention.
Click to Edit
Editing translations in MovaBase is designed to be seamless:
- Navigate to any translation value cell
- Click once to activate edit mode
- Type your translation
- Click away or press Enter to save
| Action | Description |
|---|---|
| Click Cell | Activates edit mode for that translation value |
| Type | Enter or paste your translated text |
| Auto-Save | Changes save automatically when you click away |
| Cancel | Click outside the cell to cancel edits without saving |
MovaBase automatically saves your changes as you click away from the editing cell. You do not need to manually save your edits, which reduces the risk of losing work.
Edit Mode Indicators
While editing, you will see visual indicators showing the current state:
| Indicator | Meaning | Appearance |
|---|---|---|
| Active Edit | You are currently editing this value | Cell has focus or different border |
| Modified | Value has unsaved changes | May show a small dot or asterisk |
| Linked Content | This value comes from a linked project | Different styling or badge |
| Saving | Your edit is being saved | Loading spinner or progress indicator |
Multi-Language Editing
When editing translations across multiple languages:
| Scenario | Behavior | Recommendation |
|---|---|---|
| Edit One Value | Edit the specific language cell you want to change | Most common workflow |
| Compare Languages | View multiple language columns simultaneously | Keep context while editing |
| Batch Edits | Make changes to multiple values before clicking away | Each saves independently |
| Consistency | Use the same base message across variations | Ensure consistent terminology |
Use the language columns as your reference. Keep the source language visible while translating to maintain context and ensure consistency.
Adding New Translations
Creating new translation keys is straightforward in MovaBase with support for both simple and complex structures.
Creating a New Translation Key
To add a new translation key:
- Locate the "Add Translation" button (usually near the search bar or table header)
- Click to open the add translation modal
- Enter the translation key name
- Provide values for one or multiple languages
- Choose which file this translation belongs to
- Click "Add" to create the translation
| Step | Description |
|---|---|
| Open Modal | Click the add translation button to launch the creation dialog |
| Enter Key | Type the translation key (e.g., "welcome_message", "auth.login.title") |
| Provide Values | Enter translations for each language you want to populate |
| Select File | Choose which file this translation belongs to (in file-based mode) |
| Add Translation | Click add button to create the key with all values |
Translation keys must be unique within each file. If you try to add a key that already exists, MovaBase will show an error or update the existing translation.
Key Naming Best Practices
Using consistent and descriptive key names makes your translations easier to maintain and find:
| Practice | Example | Benefit |
|---|---|---|
| Use Dot Notation | auth.login.button, user.profile.save | Logical grouping of related translations |
| Be Descriptive | checkout.payment.method, error.network_failed | Self-documenting, easier to search |
| Consistent Case | All lowercase or camelCase | Predictable and easier to type |
| Avoid Spaces | welcome_message not welcome message | Technical compatibility with most systems |
| Use Prefixes | error., success., nav. | Easy filtering and organization |
| Keep Short | btn.save not button_save_click | More readable and manageable |
Bulk Adding Translations
For adding multiple translations at once, MovaBase supports efficient workflows:
| Method | When to Use | How It Works |
|---|---|---|
| Add Multiple Values | One key, multiple languages | Add the key once, fill in all language values |
| Import from File | Upload existing translation file | MovaBase parses and creates translations |
| Copy-Paste | Copy from spreadsheet or document | Paste multiple key-value pairs at once |
| Template Duplication | Clone existing key and add with new values | Quick setup for similar content |
When adding translations for multiple languages, you can fill in values for all your configured languages at once, or choose to populate only specific languages and leave others empty.
Deleting Translations
MovaBase provides safe deletion of translations with a trash feature for easy recovery if needed.
Deleting a Single Translation
To delete a translation:
- Locate the translation row you want to delete
- Click the delete button (trash icon) for that row
- Confirm the deletion when prompted
- The translation and all its values will be removed
| Option | Description |
|---|---|
| Delete Row | Removes the entire translation key and all its language values |
| Delete Value | Removes only the value for a specific language |
Deleting a translation removes it for all languages. This action cannot be undone. Use the translation history if you need to restore deleted content.
Translation Trash Feature
The trash feature allows you to recover accidentally deleted translations:
| Feature | Description | How to Access |
|---|---|---|
| Trash View | Shows all deleted translations | Click the trash icon in the translation interface |
| Restore | Recover a deleted translation back to active use | Click restore button next to the deleted item |
| Permanent Delete | Remove a translation from trash forever | Permanently delete removes it completely |
Trash Duration
Deleted translations remain in the trash for a limited time:
| Duration | What It Means |
|---|---|
| Temporary Period | Translations are recoverable |
| Automatic Cleanup | Old items are removed permanently |
| Permanent Deletion | Manual choice to delete forever |
Regularly check and empty the trash to keep your translation workspace clean. Old deleted items can clutter the interface and make it harder to find what you need.
Translation History
MovaBase maintains a history of all changes to translations, allowing you to track modifications and restore previous versions.
Viewing Translation History
To view the history for a specific translation:
- Locate the translation in the translation table
- Click the history button (clock icon or similar indicator)
- Review the timeline of all changes to that translation
- See who made each change and when
| History Element | Description | |----------------|-------------|----------| | Change Timestamp | When the modification was made | Helps track when changes occurred | | User Who Made Change | Which team member made the modification | Accountability and tracking | | Previous Value | The value before the change | Compare with current value | | Current Value | The value after the change | See the modification |
Translation history is maintained for each translation key independently, so you can see the complete history of changes for any specific key.
Restoring Previous Versions
If you need to revert to a previous version of a translation:
- Open the history for the translation
- Find the version you want to restore
- Click "Restore" next to that version
- The translation will be updated to the selected historical value
| Scenario | How It Works |
|---|---|
| Restore Last Version | Go back to the most recent change |
| Restore Earlier Version | Revert to a specific point in history |
| Compare Before Restoring | View the old and new values side by side |
Restoring a translation replaces the current value with the historical value. Make sure you want to overwrite your current translation before restoring.
Real-Time Collaboration
MovaBase includes real-time collaboration features that help teams work together without conflicts.
Presence Indicators
See which team members are currently viewing or editing translations:
| Indicator | Meaning | Appearance |
|---|---|---|
| User Avatars | Shows which users have that translation open | Colored circles with initials or avatars |
| Cursor Position | Shows where someone's cursor is located | Helps avoid conflicting edits in same area |
| Typing Indicator | Shows when someone is actively typing | Three dots animation while user is typing |
| Edit Badge | Indicates which user is currently editing | Small badge with user name or initials |
Understanding User Cursors
User cursors show the exact position of other team members:
| Cursor Color | User | What It Means |
|---|---|---|
| Red | User A | User A is currently editing this area |
| Blue | User B | User B's cursor is positioned here |
| Green | User C | User C is viewing or has cursor here |
| Yellow | User D | User D's cursor is at this location |
Cursors help prevent overwrites by showing you exactly where other team members are focused. Avoid editing the same translation that someone else is currently editing.
Conflict Prevention
MovaBase includes features to reduce conflicts when multiple users edit simultaneously:
| Feature | Description | Benefit |
|---|---|---|
| Real-Time Updates | See others' changes as they happen | Prevents working on outdated versions |
| Edit Locking | Only one user can edit a value at a time | Prevents conflicting saves |
| Presence Awareness | See who is viewing each translation | Helps coordinate work |
| Automatic Merging | Smart handling of simultaneous edits | Combines changes intelligently |
Collaboration Best Practices
Bulk Operations
MovaBase allows you to select and act on multiple translations at once, saving time when working with large sets of translations.
Selecting Translations
You can select multiple translations in several ways:
| Selection Method | Description | When to Use |
|---|---|---|
| Row Checkbox | Click the checkbox at the start of each row | Select individual rows |
| Select All Checkbox | Check the header checkbox to select all visible rows | Select everything at once |
| Shift-Click | Click a row, then Shift-click another | Select a range of rows |
| Language Filter | Filter by language, then select all in that language | Select all translations for a specific language |
| File Filter | Filter by file, then select all in that file | Select all translations in a specific file |
Bulk Actions Available
Once you have translations selected, you can perform actions on all of them at once:
| Action | Description | Result |
|---|---|---|
| Bulk Delete | Remove all selected translation keys | All selected keys and their values are deleted |
| Bulk Edit | Prepare multiple translations for editing | Selected rows enter edit mode simultaneously |
| Copy Keys | Copy all selected translation keys to clipboard | Quick export of key list |
| Export Selection | Download only selected translations | Generate partial export files |
Bulk operations apply to all currently selected translations. Make sure you review your selection before performing bulk actions, especially for deletion which cannot be undone.
Selection Count Display
MovaBase shows you exactly how many items you have selected:
| Display | Meaning | Example |
|---|---|---|
| Row Count | Number of translation keys selected | "5 keys selected" |
| Translation Count | Total number of translation values selected | "12 translations selected" |
| Language Breakdown | Count by language | "3 en, 4 es, 5 fr" |
Use the selection count display to verify you have selected the intended items before performing bulk operations. This helps prevent accidental deletions or modifications.
Best Practices for Translation Management
Efficient Workflow
Quality Assurance
| Practice | Description | Frequency |
|---|---|---|
| Regular Reviews | Periodically review translations for consistency, grammar, and accuracy | Weekly or bi-weekly |
| Spot Checks | Randomly sample translations from different sections to verify quality | Monthly |
| Peer Reviews | Have team members review each other's translations | After major translation waves |
| Terminology Consistency | Maintain consistent terminology across all translations | Ongoing process |
Team Coordination
Troubleshooting
Common Issues
Part 5 of 14 • Translation Management Complete
Next: File Management