Translate Volunteers for Salesforce into Other Languages or Customize Terminology

Enable the Translation Workbench

Use the Translation Workbench, a standard Salesforce tool, to manage translations into other languages and custom terms in the same language. Enable it for the languages you support, and then see how it handles common tasks for translation and customizing terminology.

1. From Setup, enter Translation Settings in the Quick Find box, then select Translation Language Settings.
2. If this is your first time enabling the Translation Workbench, click Enable.

   The Translation Workbench displays the supported languages.

   
3. For each language you support:
   1. Either Edit an existing supported language or Add a new one.
   2. If you're adding translations for a language, assign translators by moving users' names to the Selected List.
   3. While the translation is in progress, leave the Active setting disabled. Remember to come back when the language is ready for use and make it Active, which makes it available to users who choose it as their personal language.
   4. Save your changes.

Override the Term for a Field or Button

A common terminology task is replacing an out-of-the-box term with your own term. Let's override a term for a button to see how to do overrides in the same language.

1. From Setup, enter Override in the Quick Find box, then select Override.
2. Specify the item to override.
   
   1. Select the Volunteers for Salesforce Package.
   2. Select the Language.
   3. Select a Setup Component from the list of translatable customizations. Only certain components can be overridden or translated.
   4. Select the Object that has the item to override. This final criteria determines which values can be changed.
      
3. Double-click in the Label Override column, in the appropriate row, and enter the new label value.
4. Repeat the label override as need for other items.
5. Save your changes.

Edit Custom Labels

The Volunteers for Salesforce Sites pages use labels whose values can be changed. While you can't directly edit these label values, you can override the default value by "translating" them into English or any of our other supported languages.

For example, you may want to translate some of these labels:

1. From Setup, enter Custom Labels in the Quick Find box, then click Custom Labels.
2. In the list of labels, click the name of the label you want to edit.
3. Click New Local Translations/Overrides.
4. Select your language.
5. In the Translation Text box, enter the label you want to use.
   
6. Click Save.

If you go to the Site page where this label is used, you see the new text.

Translate the Contact Volunteer Skills Picklist

Translate the values in a picklist so that you see how to translate terms into another language.

1. From Setup, enter Translate in the Quick Find box, then select Translate.
2. Specify the item to translate.
   
   1. Select the language you're translating into.
   2. Select Picklist Value for Setup Component.
   3. Select the Contact Object.
3. Find Volunteer Skills in the menu, then click +.
4. Double-click in the Label Translation column for each term, and enter the translation for the picklist value.
   
5. Repeat the label translation as needed for other items.
6. Save your changes.

Export All Translatable Terms for a Language

Export a translation file for a language to generate a list of all the translatable terms. The exported file can help your first-time translations and also help translators stay on top of label changes that affect their translations.

1. From Setup, enter Export in the Quick Find box, then select Export.
2. Select Bilingual.
3. Click Export.
4. Look for the email from Salesforce confirming the export is done.
5. If you're working in Lightning Experience, switch to Salesforce Classic so you can access Documents.
6. Go to the Documents tab. If you don't see the Documents tab, click the + icon at the end of the tab bar, then click Documents in the list of All Tabs.)
7. Go to the My Personal Documents folder. Next to the name of your exported .zip file, click View to save the file to your computer.
8. On your computer, extract the .zip file to get a translation file for each language that your Salesforce org has enabled. .stf files are tab-delimited text files in the Salesforce translation format.
9. We recommend renaming the file extension from .stf to .txt, so that when you open it in a spreadsheet program like Microsoft Excel, you can specify how the file is structured. If you're warned that renaming file might cause it to become unusable, confirm that you do want to rename it.
10. Open the file in your spreadsheet program.
    

    Tip If your spreadsheet program can't locate the .txt file, verify that it's looking amongst all file types, not just its own proprietary format.
11. Follow your program's instructions for importing the data. The following steps assume you're using Excel.
12. Choose the Delimited file type, with Tab delimiters.
13. Review both sections in the file to plan your edits.

    Translated terms

    Update a translation by overwriting the current translation, in Column C.

    Untranslated terms

    Specify a translation by overwriting the values in Column B.

14. Save your changes in the spreadsheet. If asked whether to keep it in the current format, choose Yes.
15. Close Excel. If asked whether to save again, choose No.
16. If you renamed the file extension from .stf to .txt, rename it again to .stf.
17. Clean up a formatting issue that Excel introduces.
    1. Open the file in a text editor such as Notepad.
    2. Open the text editor's feature that lets you find and replace text.
    3. Find all double quotation marks (") and replace them with no value.
    4. Using the text editor's Save As option, specify that the file uses UTF-8 encoding.
    5. Save the file.

Now you're ready to import the translations into V4S.

Import a Translation File

Import an edited translation file back in to Volunteers for Salesforce to add or update your language translations.

1. From Setup, enter Import in the Quick Find box, then select Import.
2. Click Choose File.
3. Select the .stf export file that you created or select a .zip file containing multiple .stf files.
4. Click Import.
5. Look for the email from Salesforce confirming a successful import or reporting import errors. If there are errors, look in the Documents tab for details.