Movabase Docs
User guide

Language Management

Adding, editing, and managing languages in your MovaBase projects

Language Management

This guide covers everything you need to know about managing languages in your MovaBase projects, from adding new languages to organizing and controlling their visibility.

Adding Languages

MovaBase supports both standard languages and custom language definitions, giving you flexibility to match your specific needs.

Adding Standard Languages

Standard languages come from a comprehensive database with pre-configured language codes, names, and native names.

Available Language Database

MovaBase includes an extensive list of supported languages with their properties:

PropertyDescriptionExample
CodeISO language code used for identificationen, es, fr, de, ja, zh-Hans
NameEnglish display nameEnglish, Spanish, French, German, Japanese, Chinese (Simplified)
Native NameName in the language itselfEnglish, Español, Français, Deutsch, 日本語, 简体中文
EmojiVisual flag or identifier🇺🇸, 🇪🇸, 🇫🇷, 🇩🇪, 🇯🇵, 🇨🇳

Language codes follow ISO 639-1 standards or common conventions. This ensures compatibility with most translation tools and platforms.

Steps to Add a Standard Language

  1. Navigate to your project and open the sidebar if not already visible
  2. Locate the "Languages" section in the sidebar
  3. Click "Add Language" button
  4. Search or browse through the available languages list
  5. Select the language you want to add
  6. Click "Add" to confirm

Use the search box to quickly find languages by name, code, or native name. This is especially helpful for languages with similar names or codes.

Adding Custom Languages

If you need a language not in the standard database, MovaBase allows you to create custom language definitions.

When to Use Custom Languages

Consider creating custom languages when:

  • Your target language has specific regional variations
  • You're working with a constructed language or dialect
  • You need to support a specialized technical terminology
  • The standard language database doesn't include your target

Custom Language Properties

When creating a custom language, you'll need to provide:

FieldDescriptionExample
CodeUnique identifier for your custom languagees-MX, fr-CA, en-US-custom
NameDisplay name in EnglishMexican Spanish, Canadian French, US Custom English
Native NameName in the language itselfEspañol de México, Français canadien, US English
EmojiVisual identifierAny emoji character or flag emoji

Custom language codes must be unique within your project. Avoid using codes that might conflict with standard ISO codes to prevent confusion.

Setting Default Language

The default language serves as your source or base language in the project.

Understanding Default Language

The default language:

  • Is typically your source language where you create original translations
  • Often the first language you add to a new project
  • Can be changed at any time
  • Affects how translations are imported and displayed

Setting or Changing Default Language

To set or change the default language:

  1. Navigate to the Languages section in your project sidebar
  2. Locate the language you want to set as default
  3. Click the "Set as Default" option (usually a star icon or menu option)
  4. Confirm the change

Only one language can be marked as default at a time. Changing the default language doesn't affect existing translations.

Language Ordering and Organization

You can organize languages in a logical order that makes sense for your workflow.

Default Ordering

By default, languages are ordered by when they were added to the project.

Reordering Languages

  1. Navigate to the Languages section in project sidebar
  2. Look for drag handles or ordering controls
  3. Drag languages to your preferred order
  4. Changes are saved automatically

Place your default language at the top or a prominent position for easy reference. Group related languages together (e.g., all Spanish variants).

NEEDS_MEDIA

Managing Languages

Once languages are added, you can manage their properties and visibility through the Languages section.

Editing Language Properties

You can modify language properties at any time to keep them accurate and up to date.

Editable Properties

PropertyCan Be EditedWhen to Edit
NameYesWhen display name needs correction or you prefer different terminology
Native NameYesWhen native name needs updating or correction
EmojiYesWhen you want to change the visual identifier
CodeNoLanguage code is unique identifier and shouldn't be changed
Default StatusYesCan set a different language as default

Steps to Edit a Language

  1. Navigate to the Languages section in your project sidebar
  2. Find the language you want to edit
  3. Click the edit button (pencil icon or similar)
  4. Modify the desired properties in the edit dialog
  5. Click "Save" to apply changes

Editing a language's properties doesn't affect the translations themselves. You're only changing the language's metadata, not the translation content.

Removing Languages

You can remove languages that are no longer needed from your project.

Before Removing a Language

Consider the following before removing a language:

ConsiderationWhy It Matters
Translation ProgressHow many translations exist for this language
Project StatusIs the language in active use
Team CommunicationAre translators still working on this language
BackupDo you have a backup of translations

Removing a language permanently deletes all translations for that language. This action cannot be undone unless you have a backup.

Steps to Remove a Language

  1. Navigate to the Languages section in your project sidebar
  2. Locate the language you want to remove
  3. Click the delete or remove button (trash icon)
  4. Confirm the deletion when prompted
  5. The language and all its translations will be removed from your project

Language Visibility Controls

MovaBase allows you to show or hide languages in the translation interface without deleting them entirely.

Understanding Language Visibility

Language visibility controls which languages appear in the translation table and editor:

Visibility StateEffect
VisibleLanguage appears in translation columns and can be edited
HiddenLanguage is excluded from view but translations remain in project

Use Cases for Hiding Languages

Showing and Hiding Languages

To toggle language visibility:

  1. Navigate to the Languages section in your project sidebar
  2. Find the language you want to show or hide
  3. Click the visibility toggle (eye icon)
  4. The language will be shown or hidden accordingly

You can show all languages at once using the "Show All" option, making it easy to reset your view.

NEEDS_MEDIA

Available Languages

MovaBase provides a comprehensive database of standard languages to choose from.

Supported Language List

The language database includes major world languages and regional variants.

Language Categories

Languages are organized into categories for easier browsing:

CategoryExamplesTypical Uses
Major LanguagesEnglish, Spanish, French, German, Portuguese, Chinese, JapanesePrimary target markets
European LanguagesItalian, Dutch, Polish, Swedish, Norwegian, DanishEuropean localization
Asian LanguagesKorean, Vietnamese, Thai, Indonesian, MalayAsian market expansion
Middle Eastern LanguagesArabic, Hebrew, Persian, TurkishMiddle Eastern markets
African LanguagesSwahili, Zulu, Amharic, YorubaAfrican markets
Regional Variantszh-Hans, zh-Hant, pt-BR, es-MXSpecific regional needs

The most commonly used languages in MovaBase:

LanguageCodeNative NameRegion
EnglishenEnglishGlobal
SpanishesEspañolSpain, Latin America
FrenchfrFrançaisFrance, Canada, Africa
GermandeDeutschGermany, Austria
PortugueseptPortuguêsPortugal, Brazil
Chinese (Simplified)zh-Hans简体中文China, Singapore
Chinese (Traditional)zh-Hant繁體中文Taiwan, Hong Kong
Japaneseja日本語Japan
Koreanko한국어South Korea
ArabicarالعربيةMiddle East, North Africa
Hindihiहिन्दीIndia

The language database is regularly updated to include new languages and language variants based on user feedback and needs.

Custom Language Creation

For languages not available in the standard database, you can create custom definitions.

Custom Language Requirements

RequirementDescriptionExample
Unique CodeMust be unique within the projectmy-custom-lang
Display NameEnglish name for identificationCustom Terminology
Native NameName in the language itselfCustom script or characters
EmojiVisual identifier for UIAny emoji character or flag

Best Practices for Custom Languages

Custom languages are project-specific and won't appear in the standard language database. Consider if the language might benefit other users before creating a custom definition.

Language Codes and Names

Understanding the components of language definitions helps you work more effectively with languages.

Language Code Structure

Language codes in MovaBase typically follow these patterns:

PatternFormatExampleRegion
ISO 639-1ll or ll-CCes, es-MXTwo-letter with optional region
Common Variantszh-Hans, zh-Hant, pt-BRScript or country variantSpecific writing system or country
Custom CodesUser-definedinternal-dev, legacy-supportProject-specific codes

Language Names

MovaBase supports multiple name types:

Name TypePurposeExample
English NameDisplay name for all usersSpanish
Native NameName in the language's scriptEspañol
CodeTechnical identifieres

The English name is shown to all users, while the native name is primarily for reference and context about the language itself.

Language Emoji Selection

Emojis provide visual identification for languages in the interface.

Emoji Guidelines

GuidelineDescription
Use Flag EmojisWhen available, use country or region flag emojis
Use Character EmojisFor languages without flag representation
Be ConsistentSimilar languages should use consistent emoji style
Avoid AmbiguityEnsure emoji clearly represents the language

Emoji Examples

LanguageFlag EmojiAlternativeWhen to Use
English🇺🇸🇬🇧Flag or globe
Spanish🇪🇸🌴️Country flag or sun
French🇫🇷🗼️Country flag or tower
German🇩🇪🍺️Country flag or beer
Portuguese🇧🇷☕️Country flag or coffee
Japanese🇯🇵🗻️Country flag or gate
Chinese🇨🇳🐉️Country flag or dragon
Arabic🇸🇦🕌️Country flag or mosque

NEEDS_MEDIA

Best Practices for Language Management

Project Organization

Team Collaboration

Document your language strategy and conventions in project documentation or team wiki. This ensures all team members follow consistent practices when adding and managing languages.

Workflow Recommendations

TaskFrequencyPurpose
Review Language UsageMonthlyIdentify which languages are actively being translated
Audit Custom LanguagesQuarterlyVerify custom languages are still needed or could be standardized
Check Visibility SettingsWeeklyEnsure language visibility matches current project needs
Update Native NamesAs neededCorrect or improve native language names based on translator feedback

Troubleshooting

Common Issues


Part 4 of 14: Language Management Complete

Next: Translation Management

On this page