Translations
RAMP supports multiple languages and allows Administrators to customize UI labels and translations for their tenant. The Translations page provides an interface for managing localized strings used throughout the application.
Required role: Administrator
Accessing Translations
Section titled “Accessing Translations”Navigate to Administration > Translations (or /_admin/translations).
How Translations Work
Section titled “How Translations Work”RAMP uses a key-based translation system where each piece of text in the user interface is identified by a unique key. Each key has a value for every supported language. When a user views the application, the text is displayed in their selected language.
Translation Sources
Section titled “Translation Sources”Translations come from two sources:
| Source | Description |
|---|---|
| Built-in translations | Default translations shipped with RAMP for all supported languages |
| Custom overrides | Tenant-specific customizations that override the built-in values |
Custom overrides take priority over built-in translations. This allows you to tailor the interface to match your organization’s terminology without affecting the base translations.
Managing Translations
Section titled “Managing Translations”Viewing Translations
Section titled “Viewing Translations”The Translations page displays all translation keys with their values for each configured language. You can:
- Search for specific keys or text values
- Filter by language
- Filter to show only keys with custom overrides
Editing a Translation
Section titled “Editing a Translation”- Find the translation key you want to modify (use the search field to narrow results).
- Click on the translation entry.
- Edit the value for the desired language(s).
- Click Save.
Resetting to Default
Section titled “Resetting to Default”If you have customized a translation and want to revert to the built-in value:
- Find the customized translation (custom overrides are typically marked with an indicator).
- Click on the translation entry.
- Click Reset to Default or clear the custom value.
- Click Save.
Custom Labels
Section titled “Custom Labels”Beyond translating existing interface text, you can use translations to customize labels that match your organization’s vocabulary.
Common Customizations
Section titled “Common Customizations”| Default Term | Example Custom Term | Typical Reason |
|---|---|---|
| ”Template" | "Runbook” | Organization uses different terminology |
| ”Instance" | "Execution Plan” | Industry-specific language |
| ”System" | "Application” | Matches internal naming |
| ”Step" | "Task” | Simpler terminology |
Multi-Language Support
Section titled “Multi-Language Support”Adding Language Support
Section titled “Adding Language Support”RAMP ships with built-in support for several languages. The available languages are determined by the translation files included in the application.
User Language Selection
Section titled “User Language Selection”Each user can select their preferred language in their profile settings. The application displays all text in the user’s selected language, falling back to the tenant’s default language for any untranslated keys.
Translation Coverage
Section titled “Translation Coverage”When customizing translations, ensure you provide values for all languages your users need. If a translation key has a custom value in one language but not another, users of the other language will see the built-in default.
Best Practices
Section titled “Best Practices”- Start with high-visibility terms — customize the most frequently seen labels first (navigation items, page titles, button labels).
- Be consistent — if you rename “Template” to “Runbook”, apply this consistently across all related translation keys.
- Test with users — after making translation changes, ask a few users to review the interface to confirm the labels make sense in context.
- Document your customizations — maintain a record of which translations you have customized and why, to ease future maintenance.
- Update all languages — when you customize a key, update the value in every language your organization uses.