Skip to main content
Version: v10.x - Umbraco 10

Property Mapping

Translation Manager comes with support for all the core Umbraco text-based property editors, as well as most of the popular 3rd party text-based property editors. However, there may be times when you have custom property editors that are not covered by the core installation.

If you have a custom property editor that stores information in the same format as an existing built in property you can map your custom property to that inbuilt editor. Translation Manager will use that mapper for your values.

note

In Umbraco 9/10 the mappings are stored in a config/translation_mapping.config file. This file does not exist by default and you will need to create it if you want to define custom mappings.

<config>
<mappers>
<mappings>
<add key="MyCustom.LinkMapper" value="Umbraco.MultiUrlPicker" />
</mappings>
</mapper>
</config>
tip

If you custom mapper is also used in the grid you should add an Umbraco.Grid.[name] mapping. to cover those situations, e.g.

<add key="Umbraco.Grid.MyCustomTextProperty" value="Umbraco.TextBox" />

You will be able to see whether you custom mappings have loaded in the Translation Manager Diagnostics tab.

These custom mappings will also be used for link mapping. If you have any controls that include links, you can use these mappings to catch those values.

e.g

<config>
<mappers>
<mappings>
<add key="MyCustom.LinkMapper" value="Umbraco.MultiUrlPicker" />
</mappings>
</mapper>
</config>