Skip to main content

Add a New Language (Basic)

Set up a new language for your application:
1

Navigate to Languages

Go to Languages page (/languages) from the sidebar
2

Select Application

Choose an application from the dropdown
3

Click Add Language

Click the Add Language button
4

Fill in Details

Complete the form:
  • Language Code - Select from standard codes (en, es, fr, hi, etc.)
  • Language Name - Auto-filled based on code selection
  • Make Default - Check if this should be the default language
5

Save

Click Add Language to create
If marked as default, sample strings will be automatically created for the language.

Add Language with AI Translation

Automatically translate all strings from an existing language using AI.

Prerequisites

OpenAI API key configured in Settings
At least one existing language with strings
Internet connection

Translation Steps

1

Navigate to Languages

Go to Languages page and select your app
2

Start Add Language

Click Add Language button
3

Enter Language Details

Fill in the new language code and name
4

Enable AI Translation

  • Check Pre-fill with AI-translated strings from existing language
  • Select Source Language from the dropdown
5

Add Language

Click Add Language to start translation process
6

Review Translations

The AI translation interface appears with:
  • Real-time progress indicator
  • Source and target text for each string
  • Individual approve/reject options
  • Edit capability before saving
7

Manage Translations

During review, you can:
  • Edit individual translations
  • Approve All to accept all translations
  • Download CSV to export for review
  • Track progress via WebSocket updates
8

Save

Click Save Approved Translations to finalize

AI Translation Features

Real-time Progress

WebSocket-powered live translation progress tracking

Inline Editing

Edit translations before saving with visual progress

Transaction Journal

Complete tracking of all translation operations

Submission Report

Detailed success/failure report after completion
Use AI translation as a starting point, then review and refine for accuracy and cultural appropriateness.

Set Default Language

Define which language is the fallback for your application:
1

Navigate to Languages

Go to the Languages page
2

Select Application

Choose your application from the dropdown
3

Find Language

Locate the language you want to set as default
4

Set Default

Click the Set Default button for that language
5

Confirmation

A success toast appears confirming the change
Only one language can be the default per application. Setting a new default automatically removes the flag from the previous default language.

Activate or Deactivate Language

Control which languages are available in your application:
1

Navigate to Languages

Go to the Languages page
2

Find Language

Locate the language in the table
3

Toggle Status

Click the Active/Inactive toggle switch
4

Status Update

The status updates immediately
Inactive languages are hidden from SDK queries but strings are preserved

Edit Language

Modify language configuration:
1

Go to Languages

Navigate to Languages page
2

Click Edit

Click the Edit icon (pencil) for a language
3

Modify Settings

Update:
  • Language name
  • Active status
  • Default status
4

Save Changes

Click Save Changes to update

Delete Language

Deleting a language permanently removes all strings for that language. This action cannot be undone.

Delete Process

1

Navigate to Languages

Go to the Languages page
2

Click Delete

Click the delete icon (trash) for the language
3

Confirm Deletion

Confirm deletion in the dialog that appears

Important Notes

You must set another language as default before deleting the current default language.
The system:
  1. Deletes all strings for the language
  2. Then removes the language configuration
Deleted strings cannot be recovered. Export data before deletion if needed.

Language Management Table

The languages table displays key information:
ColumnDescription
Language CodeISO 639-1 code (en, es, fr, etc.)
Language NameFull language name
DefaultBadge indicating default language
StatusActive or Inactive toggle
String CountNumber of strings in this language
ActionsEdit, Set Default, Delete options

Best Practices

Set Default First

Configure your primary language as default before adding others

Review AI Translations

Always review AI-generated translations for accuracy and cultural appropriateness

Consistent Codes

Use ISO 639-1 standard codes (en, es, fr) for consistency

Don't Delete Active Languages

Check string usage before deleting languages

AI Translation Tips

Use your most complete and accurate language as the translation source
Pay special attention to:
  • Brand names (should not be translated)
  • Technical terms
  • Placeholders and variables
  • Cultural references
Export translations as CSV to share with:
  • Native speakers
  • Localization team
  • Product managers
  • Start with AI translation
  • Review and edit critical strings
  • Test in-app
  • Refine based on feedback

Troubleshooting

Check:
  • OpenAI API key configured in Settings
  • API key format is correct (starts with sk-)
  • At least one existing language with strings
  • Internet connection is active
Possible causes:
  • Language is set as default (set another language as default first)
  • Permission issues
  • Active strings still associated
Solution: Check default status and ensure you have proper permissions
Improve results by:
  • Using high-quality source strings
  • Adding clear descriptions to strings
  • Reviewing and editing output
  • Consulting native speakers

Next Steps