Property Description Formatting/HTML Not Working with Document Type Localization in v17

Hi all,

I’m working on a multilingual backoffice setup in Umbraco 17 using Document Type localization as described in the official documentation.

I’ve successfully set up localization for property labels, tab names, etc., but I’m running into an issue with formatted property descriptions.

What works:
When I enter a property description directly in the Document Type editor (not using localization), I can use HTML tags and line breaks that render correctly

What doesn’t work:
When I use localization for the same description, the HTML tags and formatting don’t render - they show as literal text.


In the Document Type, the description field is set to:
{#properties_pageName-desc}

The result:
The description displays as plain text with visible <i> and <b> tags instead of rendering them as HTML. Line breaks (\n\n) also don’t work.

What I’ve tried:

  • Using <i>, <em>, <strong>, <b> tags

  • Using <br>, <br /> for line breaks

  • Using \n\n for paragraph breaks

  • Using template literals with actual line breaks

  • Using Markdown syntax (*italic*, **bold**)

None of these approaches render the formatting when the text comes from a localization file, even though the exact same HTML works when entered directly.

Questions:

  1. Is there a way to include HTML/formatting in localized property descriptions?

  2. Is this a known limitation of the Document Type localization system?

  3. Are localized strings HTML-escaped before being rendered as UFM, preventing any formatting?

2 Likes