Skip to content
New: 3 GARAN labels for free, no sign-up neededCreate now
EU legal guarantee
and GARAN label
GuideUpdated 9 October 20265 min read

Add the legal guarantee notice to JTL-Shop

The official EU legal guarantee notice in your JTL-Shop in a few minutes, with the free widget.

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

  1. Use a child template
    Changes belong in a child template (for NOVA: NOVAChild) so that updates do not overwrite them.
  2. 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.
  3. 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.
  4. Check
    Clear the cache or publish the draft and check an item.

Things to know about JTL-Shop

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

Further sources

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.

GARAN label done, for free.

Your first 3 labels are free. On Shopify, our app adds both EU labels automatically.