Skip to main content

Fields and properties

WirdThis synchronisiertpage lists the fields both sources deliver. In the builder you map them to the parts of your element.

Product

idInternal identifier of the product in the shop. Unique, but not meant for visitors. nameProduct name. article_noArticle number as maintained in the shop. descriptionFull description, contains HTML from the shop. short_descriptionShort description. stockStock level as a number. in_stockYes/no — more convenient for conditions in the builder than the numeric value. seo_urlReadable address of the product, relative to the shop. shop_urlFull address of the product in the shop — assembled from the shop base URL. The field for "go to product" links. created_atCreation date. updated_atDate of the last change. main_imageThe first image of the product — the normal case for cards and grids. pricePrice details, see below. imagesAll images as a list, with a maximum count. attributesAttributes as a list. variationsVariations as a list. merkmaleCharacteristics as a list.

description contains the markup from the shop. If your element outputs the text escaped, visitors will see the HTML tags. Use an element that allows HTML in that case, or short_description.

Price

price_netNet price as a number. price_grossGross price as a number. formatted_netNet price as a ready-made string with currency. formatted_grossGross price as a ready-made string with currency. rrpRecommended retail price, if maintained in the shop. has_discountYes/no — whether the price is below the recommended retail price. currencyCurrency code from the plugin settings.

On displaying prices: which price actually applies in the shop depends on customer group, tiered prices and promotions. This extension reads the stored default price. If your shop works with customer-group-dependent prices, check whether the display on the website matches — and point out where appropriate that the price in the shop is the binding one.

Image

idIdentifier of the image. sort_orderOrder as maintained in the shop. url_small, url_medium, url_largeThe three sizes JTL generates — each as a full address.

All three addresses are assembled from the shop base URL. If it is not set, the images lead nowhere.

Attribute

idIdentifier of the attribute. nameLabel — in the language from the plugin settings, if translated. valueValue. formattedLabel and value as a ready-made string.

Variation

idIdentifier of the variation. article_noArticle number of the variation. stockStock level of the variation. in_stockYes/no.

Characteristic

merkmal_id, merkmal_nameIdentifier and label of the characteristic, "colour" for instance. wert_id, wert_nameIdentifier and label of the value, "blue" for instance. sort_orderOrder from the shop.

Characteristics are optional in JTL. If your shop does not use them, the fields stay empty and the selection list in the builder is empty — that is not an error.

The field names merkmale, merkmal_id, merkmal_name, wert_id and wert_name are German on purpose: they are the names JTL itself uses, and renaming them would break every existing layout.

Applies to version 1.12.0.