Translate Salesforce Knowledge

Below is a step by step guide for integrating Localize with your Salesforce Service Cloud Knowledge base.

If you do not have a Localize project yet, sign up here!

1. Add Localize as a CSP Trusted Site

The Lightning Component framework uses Content Security Policy (CSP) to impose restrictions on content. To use third-party APIs that make requests to an external server (like Localize), you'll need to add a CSP Trusted Site.

Navigate to your CSP Trusted Sites list within your Salesforce Community Settings by using the Quick Find box.

Select New Trusted Site, and add Localize as a CSP Trusted Site, entering the following:

1. Trusted Site Name: "Localize"
2. Trusted Site URL: "https://global.localizecdn.com"
3. Active: select the checkbox
4. Description: add a description if desired
5. Context: select Communities
6. Click Save

See detailed Salesforce instructions here...

2. Add Localize to your Security Settings

Script resources, such as JavaScript, must be whitelisted in the Security settings of Community Builder.

Navigate to the Salesforce Community Builder > Settings > Security page.
Select + Add Trusted Site

Add Localize as a Trusted Site, entering the following:

1. Name: "Localize"
2. URL: "https://global.localizecdn.com"
3. Active: select the checkbox
4. Click Add Site

3. Add the Localize Code Snippet

Navigate to the Salesforce Community Builder > Settings > Advanced
Select Edit Head Markup

Copy the following Localize Code Snippet...

<script src="https://global.localizecdn.com/localize.js"></script>
<script>!function(a){if(!a.Localize){a.Localize={};for(var e=["translate","untranslate","phrase","initialize","translatePage","setLanguage","getLanguage","detectLanguage","getAvailableLanguages","untranslatePage","bootstrap","prefetch","on","off","hideWidget","showWidget","getSourceLanguage"],t=0;t<e.length;t++)a.Localize[e[t]]=function(){}}}(window);</script>

<script>
  Localize.initialize({
    key: '[[app:key]]', 
    rememberLanguage: true,
    // other options go here, separated by commas
  });
</script>

...and paste it into the Head Markup dialog.

Add Initialization Options

Add any desired options to the Localize.initialize() call above, check here for the full list of possible options.

Some popular options include:

• autoApprove - use to fully automate your translation workflow
• localizeImages - allows for localization of images in your site

Then select Save.

4. Publish your Community

Your Salesforce setup should now be complete! All you have left to do is to publish the changes to your community for them to become active.

5. Reload your website

1. Visit your website in a browser.
2. Select one of your target languages using the language-switching widget.
3. Refresh the page.
4. Lather, rinse, repeat, for each page on your site.

Localize will automatically begin to detect new content on the pages that you visit, and will bring it into your dashboard.

6. Approve phrases

Then head on over to the Manage Phrases page to approve phrases in the Localize dashboard.

Phrases not showing up?

If you are not seeing phrases show up in your Pending bin in the Localize dashboard, try toggling the Localize widget to a different language and then refresh again or follow the troubleshooting instructions here.

Need Help?
Contact support for custom integration help or troubleshooting!