Dynamics Community Forum Thread Details

Hello SM Rafi,

You've encountered a common localization challenge in Dynamics 365 Customer Engagement (on-premises) v9.1, specifically with the Unified Client Interface (UCI) app: the "Recent" and "Pinned" items labels in the navigation bar remain in English when switching languages.

Here's a breakdown of the issue and how to address it:

Understanding the Problem:

UCI Localization: While most labels and UI elements in UCI are localized based on the user's language preferences, certain system components might not fully adhere to the localization settings.
System Labels: The "Recent" and "Pinned" items labels are considered system labels, and their localization can be tricky.
Site Map Ineffectiveness: As you've discovered, these labels are not directly configurable through the site map editor.
Version Specifics: Dynamics 365 on-premises v9.1 has some localization quirks that were refined in later versions.

Solutions and Workarounds:

System Localization Customizations (Recommended):
- Translation Files: Dynamics 365 uses translation files (also known as resource files) to store localized labels. You can modify these files to change the "Recent" and "Pinned" labels.
- Steps:
  1. Export Translations:
    - Go to Settings > Customizations > Customize the System.
    - Click Export Translations.
    - Select the system components (or all components) for export.
    - Download the exported translation file (a ZIP file containing XML files).
  2. Modify Translation Files:
    - Extract the ZIP file.
    - Open the XML file corresponding to the language you want to modify (e.g., <language code>.xml).
    - Search for the English labels "Recent" and "Pinned".
    - Replace the English labels with the localized labels for your target language.
    - Save the XML file.
  3. Import Translations:
    - Go back to Settings > Customizations > Customize the System.
    - Click Import Translations.
    - Select the modified ZIP file.
    - Publish your customizations.
  4. Test:
    - Change the user's language to the modified language and verify the labels.
- Advantages:
  - Supported by Microsoft.
  - Provides a comprehensive way to localize system labels.
- Disadvantages:
  - Requires careful editing of XML files.
  - Can be time-consuming.

JavaScript Workaround (Potentially Brittle):
- JavaScript Web Resource: You can use JavaScript to find the label elements and change their text.
- Steps:
  1. Create JavaScript Web Resource: Create a JavaScript web resource with code to find the "Recent" and "Pinned" label elements and change their text.
  2. Add JavaScript to Application Ribbon: Add the javascript to the application ribbon. This will cause it to run when any page in the application is loaded.
  3. Language Detection: Use JavaScript to detect the user's language preferences.
  4. Label Replacement: Replace the English labels with the localized labels based on the detected language.
- Advantages:
  - Can be implemented without modifying translation files.
- Disadvantages:
  - Unsupported: Modifying the DOM directly is not officially supported and can break with updates.
  - Complex: Requires JavaScript development skills.
  - Brittle: The DOM structure can change with updates, breaking your code.
  - Performance impact.

Browser Extensions (User-Side, Limited Control):
- Concept: Develop a browser extension that intercepts the UI and changes the labels.
- Limitations:
  - Only works for users who install the extension.
  - Not a reliable solution for a production environment.
  - Security concerns.

Recommendation:

The recommended approach is to modify the system translation files. This is the most reliable and supported way to localize the "Recent" and "Pinned" labels.
The javascript solution is not recommended, due to it being unsupported.

Important Considerations:

Testing: Thoroughly test your localization changes in a non-production environment.
Backup: Always back up your translation files before modifying them.
Version Compatibility: Ensure that your localization changes are compatible with your Dynamics 365 version.

By following these steps, you should be able to localize the "Recent" and "Pinned" items labels in your Dynamics 365 UCI app.

If my answer was helpful, please click Like, and if it solved your problem, please mark it as verified to help other community members find more. If you have further questions, please feel free to contact me.

My response was crafted with AI assistance and tailored to provide detailed and actionable guidance for your Microsoft Dynamics 365 query.

Regards,

Daivat Vartak

Community site session details

Navigation Menu Bar Recent and pinned are not localized to other langugae

Helpful resources

Quick Links

Responsible AI policies

Neeraj Kumar – Community Spotlight

Congratulations to the November Top 10 Community Leaders!

Leaderboard > Customer experience | Sales, Customer Insights, CRM

Featured topics

Product updates