Use localized labels with ribbons


Updated: November 29, 2016

Applies To: Dynamics 365 (online), Dynamics 365 (on-premises), Dynamics CRM 2016, Dynamics CRM Online

Although Ribbon elements that display text allow for direct entry of text, it is a best practice to use localized labels to define text displayed in the ribbon. This enables multi-language capabilities and better management of shared text.

The <RibbonDiffXml> (RibbonDiffXml) element includes the <LocLabels> (RibbonDiffXml) element. As shown in the following example, this is where you can specify which text to display in the ribbon labels and tooltips using the <Titles> (RibbonDiffXml) element.

 <LocLabel Id="MyISV.account.SendToOtherSystem.LabelText">
   <Title languagecode="1033"
          description="Send to Other System" />
 <LocLabel Id="MyISV.account.SendToOtherSystem.ToolTip">
   <Title languagecode="1033"
          description="Sends this Record to another system" />

Within the definition of a ribbon element that displays text, the following example show how the localized label can be referenced using the $LocLabels: directive.


If you have a ribbon control label that is very long, the text will wrap to fit the available space. You can specify where you want to include a line break by using the following characters: &#x200b;&#x200b;.

If the label text is very long without a space for the text to wrap, the width of the control expands to allow for the entire label to be displayed.

Microsoft Dynamics 365

© 2016 Microsoft. All rights reserved. Copyright