In JTL-Shop 5, you add the legal guarantee notice for all items via the child template of the item detail page. For individual items, the OnPage Composer with a text portlet in source code view also works.
New since JTL-Shop 5.8: JTL-Shop has both labels built in. You switch them on under Darstellung → Einstellungen → Global (View → Settings → Global), section “Gewährleistungs- und Garantielabel”. JTL shows the legal guarantee notice in the order overview, on the page “Gesetzliche Gewährleistung” in the footer and as a PDF attached to the order confirmation, but according to JTL not on the product detail page. That is what the widget is for. JTL reads the GARAN label from the Wawi function attributes jtl_guarantee_manufacturer, jtl_guarantee_model_identifier and jtl_guarantee_years.
The code for JTL-Shop
<div data-garantielabel></div>
<script src="https://www.garantielabel.app/widget.js" async></script>Set further options such as display and language in the code builder.
Step by step in JTL-Shop
- Use a child template
Changes belong in a child template (for NOVA: NOVAChild) so that updates do not overwrite them. - Extend the template
In the child template, extend the template of the item detail page and place the widget code below the add-to-basket button. It then applies to all items. - Single item
For one item only: in the OnPage Composer, drag a text portlet below the add-to-basket button and paste the code in source code view. The OnPage Composer edits each page separately. - Check
Clear the cache or publish the draft and check an item.
Things to know about JTL-Shop
- Without the OnPage Composer (JTL-Shop 4), paste the code into the template of the item detail page.
- If minify is active in the template,
widget.jsmust not be processed with it; it loads directly from garantielabel.app.
Where the notice belongs in JTL-Shop
The NOVA template builds the item detail page from productdetails/details.tpl. There, the block productdetails-details-include-basket includes the buy area. The add-to-basket button itself sits in productdetails/basket.tpl, in the block productdetails-basket-add-to-cart. In the child template, you create the file with the same path and extend the block with append or prepend. This keeps the original content, and the buy area does not change.
From JTL-Shop 5.8, the shop has both labels built in. You switch them on under “Darstellung → Einstellungen → Global” (Display → Settings → Global), in the section “Gewährleistungs- und Garantielabel” (legal guarantee and guarantee label). JTL then shows the legal guarantee label in the order overview and on the page “Gesetzliche Gewährleistung” (legal guarantee). JTL adds this page automatically to the footer area “Gesetzliche Informationen” (legal information), the link group with the template name “Fuss”. JTL does not mention the item detail page for the legal guarantee label. There, the widget adds the notice.
Child items, function attributes and GARAN label
JTL-Wawi distinguishes variation items and child items (formerly variation combinations). Variations without child items are not separate items, so many settings cannot be made per variation. Child items, by contrast, are items of their own. They inherit attributes and characteristics, for example, from the parent item, but can be maintained like ordinary items.
The built-in guarantee label (GARAN label) reads three function attributes from JTL-Wawi: jtl_guarantee_manufacturer for the producer, jtl_guarantee_model_identifier for the model identifier and jtl_guarantee_years for the duration in years. From JTL-Wawi 2.1 they already exist, but they must be activated for the online shop. If one of the three values is missing, the shop shows no guarantee label for that item. If child items have their own model identifiers, enter jtl_guarantee_model_identifier on each child item.
You choose separately where the label appears: item list, item detail page, basket, order overview and order confirmation. On the item detail page, it sits below the item number, GTIN, category and manufacturer. If you use the built-in guarantee label, leave out data-garan-voll and data-garan-klein in the widget, otherwise the label appears twice.
Typical pitfalls in JTL-Shop
- Off by default: According to JTL, both labels are deactivated at first. After the update to 5.8, you have to switch them on yourself.
- Synchronisation: New guarantee data only appears in the shop after an online shop synchronisation from JTL-Wawi.
- Guarantee duration: According to JTL,
jtl_guarantee_yearsmeans the total duration from purchase. With 3 years, it is 3 years in total, not 5. - Child template: The folder name must match the name in
template.xml, withNOVAas the parent template. The child only contains the changed files. After activating it, clear the template cache.
Further sources
- JTL-Guide: Setting up legal guarantee and guarantee labels in JTL-Shop (German)
- JTL-Guide: Global settings in detail (German)
- JTL-Guide: Item glossary (German)
- JTL-Guide: Item master data, child items (German)
- JTL developer guide: Creating a child template (German)
- JTL-Shop 5.8.1: NOVA template productdetails/details.tpl (GitLab)
Legal guarantee notice in the order confirmation
According to the Commission’s guidelines, the notice should also appear in the confirmation email. You maintain the email templates in the JTL-Shop back end under the email templates. The official graphic can be added as an image to the order confirmation. A plain link is unlikely to count as a durable medium (CJEU, Case C-49/11, Content Services); the safest way is to put the notice directly in the email as an image, text or attachment. You will find the official files on our download page.
Producer guarantee? Then add the GARAN label
If the producer gives a commercial guarantee of durability of more than two years free of charge for the whole good, the GARAN label also belongs on the product page. With the GARAN label generator you create it in seconds from years, brand and model, your first three labels free and without sign-up. Below every finished label you get an embed code with permanent image URLs: you upload nothing and paste it into JTL-Shop as shown above.
Prefer your own files? Then upload the full and the nested version to the media library of JTL-Shop and enter the addresses in the widget code:
<div data-garantielabel
data-garan-voll="https://…/GARAN-MX-500.svg"
data-garan-klein="https://…/GARAN-MX-500-nested.svg"></div>The widget then shows the nested version below the legal guarantee notice, and one click opens the full GARAN label.
Frequently asked questions
Does this work with JTL-Wawi data?
Yes. If you maintain the addresses of the GARAN labels as an item attribute and output them in the template in data-garan-voll and data-garan-klein, each item shows the matching label.
Do I need a plugin?
No. The child template is enough. An HTML portlet is only available as a plugin from the Extension Store, and you do not need it.
Will updates overwrite it?
No, if the change is in the child template. Content from the OnPage Composer is also kept.
Does JTL-Shop 5.8 show the labels by itself?
Yes, once you switch them on under “Darstellung → Einstellungen → Global”. Both are off by default. The legal guarantee label then appears in the order overview and on the page “Gesetzliche Gewährleistung”, the guarantee label in the places you choose.
Why is the guarantee label missing for an item?
Usually one of the values jtl_guarantee_manufacturer, jtl_guarantee_model_identifier or jtl_guarantee_years is missing, or the online shop synchronisation is still pending. Also check that the function attributes are activated for the online shop.
Which block do I add the widget to?
For example with append to the block productdetails-details-include-basket in productdetails/details.tpl of the child template. It then sits directly after the buy area.