Customizing the Web Widget

String Parameter



Source language of the page.


Translation “behavior” of the widget, default is manual however the user can always override the behavior which persists for the browser session.

  • =manual
  • – Translation is only invoked when the user clicks “go” on the widget.
  • =notify
  • – If the browser locale is different than the page and is a supported MT language then show the toolbar and offer to translate the page.
  • =auto
  • – If the browser locale is different than the page and is a supported MT language then kickoff translation automatically.
  • =preview
  • – The widget appears normally but all functionality is disabled. This is used on the adoption portal.


Override the UI locale, default is according to the client’s browser accept-language setting. We accept any .NET supported language and fallback to English if it is something we do not localize to.


Comma delimited list of additional languages to show. For instance:

'/ajax/v3/widgetv3.ashx?siteData= ... &ctf;=True&from=en&showlanguages=fr,de,it'
We accept any valid .NET language however unless the API accepts it the page will not get translated. Note that it is possible to add languages whose names we do not localize in which case the language name will always appear in English.


Comma delimited list of languages to hide. For instance:

'/ajax/v3/widgetv3.ashx?siteData= ... &ctf;=True&from=en&hidelanguages=fr,de,it'


Language code to override the default target language.


Whether or not to show the launcher (true/false).


To enable or disable the CTF suggestions feature. 'noanon' prevents anonymous users from making suggestions (true/false/noanon).


The list of languages to override the default language list.


Use this value as the category field for all API calls. For instance:

'/ajax/v3/widgetv3.ashx?siteData= ...&from=en&layout=ts&category=<category ID>

While it does not impact the widget snippet there is also a feature that triggers translation on any page hosting the widget by appending “?__mstto=(target language)” to the page URL. Here’s an example: "".