Description Templates
A description template defines how the description of a listing is built: headings, the item's description text, its key features, its technical data, free blocks of your own (shipping and warranty notes, say) and separator lines. You maintain a template once; merchantCENTRAL renders it into HTML for every listing in the language of its sales channel, and the connector sends that HTML.
Open the page
- Search: Description Templates
- merchantCENTRAL Setup → Description Templates
Create a template
| Field | Description |
|---|---|
| Code | Unique code of the template. |
| Description | What the template is for. |
| Base Language | The language the headings and free blocks of the template are written in. Empty means the language of item texts from the merchantCENTRAL setup. |
Under Sections you put the description together in the order you want. Move Up and Move Down move a section together with its translations.
Section types
| Type | What it shows |
|---|---|
| Heading | The Heading Text in the chosen Heading Level (H2 is the largest). |
| Description Text | The listing's effective description: the channel description, else the item's marketing text, else the text of an external source, else the item description – in a channel of another language their counterparts in that language. See Item Details. Plain text is set in paragraphs, HTML is taken over sanitized. |
| Key Features | The key features of the listing or the item in the channel's language, as a list. |
| Technical Data | The item attributes of the listing as a table of name and value – for a variant its own values first. Numbers show with their unit. In a channel of another language names and values are in that language; an attribute without a translation is left out of the table rather than shown in the wrong language. |
| Free Block | Content of your own from the rich text editor – shipping terms, warranty, your shop's presentation. |
| Separator | A horizontal line. |
Connectors can add section types of their own that apply to their marketplace only.
Headings and separators without content are left out: they appear only when a section after them shows something. A French sales channel without French key features therefore gets no heading over an empty list. When no section has content, the description is empty.
Source credits: when an external source (a product data provider, say) requires a source credit, it is appended to the description text. When a template has no Description Text section, the credit goes at the end of the description.
Write a free block
Select the section and choose Edit Section (or click into the Free Block column). The section card opens the block in the rich text editor.
Scripts, forms, embedded frames and objects, event attributes (onclick …) and links with schemes other than http(s), mailto and tel are removed when the description is rendered. Marketplaces such as eBay reject such active content.
Languages
A sales channel gets the description in its language (field Language on the sales channel):
- Headings and free blocks: on the section card, enter the heading or free block per language under Translations (Edit Free Block opens the rich text editor). When a section has no translation into the channel's language, the channel gets the text in the template's Base Language.
- Description text, key features, technical data come from the item data in the channel's language – as without a template. Without a translation there, the section stays empty.
German counts as one language: with German item texts, a translation into DEU also serves a channel in DEA or DES. A translation into the template's base language cannot be created – its texts are on the section itself.
Assign a template
Which template a listing uses is decided by the first place that names one:
- Listing: field Description Template on the marketplace item card.
- Sales channel: column Description Template in the list of sales channels on the marketplace card, or on the sales channel card.
- Marketplace: field Description Template in the Listing Description section of the marketplace card.
When no place names a template – or the template has no sections –, the listing sends its description text as it is, as before. A template still assigned to a marketplace, a sales channel or a listing cannot be deleted.
Whether a marketplace uses the template is up to its connector; the connector's help page says so. Marketplaces whose listings send no description at all (Ariba, for instance) do not show the description fields.
Send changes to the marketplaces
A changed template or assignment does not mark the listings for update by itself – only the assignment on the listing does. Afterwards choose Mark Listings for Update on the template card: every listing sent with this template goes out again with the next product upload.
Preview
- Marketplace item card → Preview Description shows the description the listing sends as the buyer sees it, with the HTML below. In the Language field you choose a further language of the sales channel.
- Template card → Preview with Marketplace Item asks for a marketplace item and shows its description with this template – also before the template is assigned.
For developers
Connectors call ALN MC Desc. Template Mgt. (codeunit 73335503):
| Procedure / event | Purpose |
|---|---|
Render(MarketplaceItem) |
Description in the language of the sales channel. Without a template the effective description as it is. |
Render(MarketplaceItem, LanguageCode) |
The same in a further language of the channel. |
RenderWithTemplate(MarketplaceItem, TemplateCode, LanguageCode) |
With a given template. |
GetEffectiveTemplateCode(MarketplaceItem[, Source]) |
Effective template and where it comes from (listing, sales channel, marketplace). |
GetChannelTemplateCode(MarketplaceCode, SubAccountCode, Source) |
Template of a channel without a listing. |
ShowPreview(MarketplaceItem[, LanguageCode]) |
Preview for connector cards. |
MarkListingsForUpdate(TemplateCode) |
Mark the listings of a template for upload. |
UsesListingDescription(MarketplaceCode) |
Whether the marketplace sends a description. The marketplace's content profile decides (field Description, Supported). A connector without a description seeds it as not supported in OnSeedChannelContentProfile (AddDefault(…, Description, false)); the hub then hides template, channel description and preview. |
OnRenderSection |
Render section types of your own (enum extension of ALN MC Desc. Section Type). The HTML is taken as it comes. |
OnAfterRender |
Post-process the rendered description. Not raised without a template. |
HTML helpers in ALN MC Content Tools: SanitizeHtml, IsHtml, PlainTextToHtml, HtmlToPlainText, EscapeHtml, BuildHtmlList.
SanitizeHtml works with an allowlist: every tag is rebuilt from an allowed name and allowed attributes, everything else goes, and leftover </> are escaped. Render can return '' (no content in the channel's language) – the connector decides what it sends then.