What This Page Does

The Translation Manager lets you edit all the text that appears on your website in 25 different languages. You can change button labels, page titles, error messages, video player text, and everything else visitors see when browsing your site. Changes take effect immediately when you click Save.

[Screenshot: page-overview]

How to Get Here

Navigate to Admin Panel > Templates > Translations

Understanding the Page

When you first open the Translation Manager, you'll see a statistics bar at the top showing how many translation keys exist, how many languages are available, and how many changes you've made but not yet saved.

Statistics Bar

Four boxes display current status:

• Total Keys - How many pieces of text are available to translate
• Languages - How many language files exist (25 by default)
• Categories - How text is organized (common, videoplayer, errors, etc.)
• Unsaved Changes - How many edits you've made but haven't saved yet

Toolbar

The toolbar lets you control what you see:

Search Box - Type keywords to find specific translations

• Category Filter - Show only translations from one category (like videoplayer or errors)
• Language - Choose which language you want to edit
• Compare With - Show a second language side-by-side to compare translations
• Status Filter - Show all translations, only missing ones, or only ones you've modified
• Changes Indicator - Yellow badge showing how many unsaved changes you have
• Save All Button - Green button to save all your changes at once

Translations Table

The main table shows all your translations in rows. Each row has:

• Key - The name of the translation (like "common.home" or "videoplayer.views")
• Value - A text box where you edit the translation
• Compare - (Only shows when you select a comparison language) The same text in another language
• Actions - A trash icon to delete the translation

The text boxes turn yellow with an orange border when you edit them, showing they're not saved yet.

Navigation Bar

Below the page title, you'll see links to other Template Management System pages like Themes, Files, Features, and Styles. The Translations link is highlighted in green because that's the current page.

Common Tasks

How to Edit a Translation

When you need to change text that appears on your site.

1. Select the language you want to edit from the Language dropdown (defaults to English).
2. Find the translation you want to change:

• Type keywords in the Search box to find it quickly
• Or use the Category dropdown to narrow down the list
• Or scroll through the pages using the page numbers at the bottom

1. Click in the text box (textarea) for that translation.
2. Edit the text. The box turns yellow to show it's been changed.
3. Continue editing other translations if needed. Your changes are remembered even if you go to another page.
4. When you're done, click the green Save All button at the top right.
5. A green notification appears confirming your changes were saved.

[Screenshot: edit-translation]

How to Add a New Translation

When you need to add text that doesn't exist yet.

1. Click the Add Key button at the top of the page (white button with green text).
2. Choose a Category from the dropdown:

• Select an existing category like "common" or "videoplayer"
• Or choose "+ New Category" and type a new category name

1. Enter the Key Name - This is the identifier (like "welcomemessage" or "subscribebutton"). Use only letters, numbers, and underscores.
2. Enter the English Value - The actual text in English that should appear.
3. Click the green Add Key button.
4. A green notification confirms the key was added.
5. The translations list refreshes to show your new entry.

[Screenshot: add-new-key-modal]

How to Delete a Translation

When you need to remove text that's no longer used.

1. Find the translation you want to delete.
2. Click the trash icon in the Actions column on the right.
3. A popup asks you to confirm: "Delete translation key '[name]'? This will remove it from the current language file."
4. Click OK to confirm.
5. A green notification confirms the key was deleted.
6. The list refreshes automatically.

How to Compare Two Languages

When you want to see how a translation looks in another language.

1. Select the main language you want to edit in the Language dropdown.
2. Select a second language in the Compare With dropdown.
3. A third column appears in the table showing translations from the comparison language.
4. Translations that are missing in either language show in red italic text.
5. This helps you identify what still needs to be translated.

[Screenshot: compare-languages]

How to Find Missing Translations

When you need to see what hasn't been translated yet.

1. Select the language you want to check in the Language dropdown.
2. Select Compare With to show English (or another complete language) for reference.
3. Choose Missing Translations from the Status Filter dropdown.
4. The table now shows only translations that are missing in either the main language or the comparison language.
5. Missing translations appear in red italic text.
6. Edit each missing translation by clicking in the value box and typing the translation.
7. Click Save All when you're done.

How to Export Translations

When you want to back up a language file or transfer it to another site.

1. Select the language you want to export from the Language dropdown.
2. Click the Export button at the top of the page.
3. Your browser downloads a file (like "en.json" for English).
4. A green notification confirms the export.
5. Save this file somewhere safe as a backup.

How to Import Translations

When you want to add translations from a file or restore a backup.

1. Click the Import button at the top of the page.
2. Select the Target Language you want to update (which file to change).
3. Choose Import Mode:

• Merge - Adds new translations and updates existing ones without deleting anything. Safe option.
• Replace - Completely replaces the entire language file. Use with caution.

1. Paste the JSON content into the large text box. This should be the content from a .json file.
2. Click the green Import button.
3. If the JSON is valid, a green notification shows how many translations were imported.
4. The modal closes and the list refreshes.

[Screenshot: import-modal]

Filters and Search

Searching

Type any word or phrase into the Search box at the top. The search looks through:

• Translation key names (like "common.home")
• Translation values in the selected language
• Translation values in the comparison language (if you have one selected)

Results update instantly as you type. The table shows only translations matching your search.

To clear the search, delete the text in the search box.

Filtering by Category

Categories group related translations together. Common categories include:

common - General site-wide text like "Home," "Login," "Search"

• videoplayer - Video playback interface text
• errors - Error messages
• auth - Login and registration pages
• user - User profile and settings
• creator - Creator monetization pages

Select a category from the Category dropdown to show only translations in that group. Choose "All Categories" to show everything.

Filtering by Status

View Modes

The translations always appear as a table. You can:

• Sort by key name (they're in alphabetical order)
• Resize the text boxes by dragging the bottom-right corner
• See more details by selecting a comparison language

Tips for New Users

Troubleshooting

Changes won't save

What you see: You click Save All but get a red error message saying "Failed to save translations."

How to fix it:

1. Check that you're logged in. If your session expired, log in again.
2. Contact your system administrator - the language files folder might not have the correct permissions.
3. Make sure you have disk space available on your server.

Text isn't updating on my website

What you see: You saved translations successfully, but the old text still appears on your site.

How to fix it:

1. Clear your browser cache by pressing Ctrl+Shift+R (Windows) or Cmd+Shift+R (Mac).
2. Try viewing the page in a private/incognito window.
3. If you have server caching or a CDN, clear those caches too.
4. Verify you edited the correct language - check which language your visitors are viewing.

Can't add a new key - says "Key already exists"

What you see: When adding a new translation, you get an error saying the key already exists.

How to fix it:

1. Use the search box to find the existing translation with that key name.
2. Edit the existing translation instead of adding a new one.
3. If you need a different translation, use a different key name.

Import fails with "Invalid JSON" error

What you see: When importing, you get a red error message about invalid JSON.

How to fix it:

1. Copy your JSON content to jsonlint.com to check for errors.
2. Make sure all text is surrounded by double quotes (not single quotes).
3. Remove any trailing commas after the last item in lists.
4. Ensure the content starts with { and ends with }.

Demo mode banner appears and I can't edit

What you see: An orange banner at the top says demo mode is active, and Save/Add/Import buttons don't work.

How to fix it:
This is expected if the site is in demo mode. Contact your system administrator to disable demo mode if you need to make edits.

Key not found when trying to delete

What you see: You click the trash icon to delete a translation and get an error saying "Key not found."

How to fix it:

1. The key might have already been deleted. Refresh the page to see the current list.
2. Make sure you're viewing the correct language file.

Unsaved changes indicator stuck

What you see: The yellow "unsaved changes" badge shows a number even though you haven't edited anything.

How to fix it:

1. Refresh the page - this clears the memory of unsaved changes.
2. If you have actual unsaved changes you want to keep, click Save All first before refreshing.

Understanding Special Text

Placeholders

Some translations include special text in curly braces like {username} or {count}. These are placeholders that get replaced with real values when the page loads.

Example:

• Translation: "Welcome, {username}!"
• Displays as: "Welcome, John!"

HTML in Translations

Some translations might include HTML code like <a href="/terms"> for links or <strong> for bold text.

Available Languages

Your site supports 25 languages. Each language has its own file:

Related Pages

This guide shows you how to use the Translation Manager to change text on your site. All translations take effect immediately after you save them.