For the complete documentation index, see llms.txt. This page is also available as Markdown.

Setup guide

Install the app, enable it in your theme, and assign your first EPREL number — from zero to a live energy badge.

1

Installing the app

You can install the EU Energy Label app directly from the Shopify App Store:

  1. On the app listing page, click Install.

  2. In your Shopify admin, confirm app permissions and click Install again to authorize.

  3. After installation, select your subscription plan.

The app will then be available on the Apps page in your Shopify admin.

2

Enabling the app embed in your theme

To activate the energy labels across your storefront:

  1. Go to Online store → Themes in your Shopify admin.

  2. Click Customize next to the theme you want to use.

  3. In the editor, open the App embeds panel (bottom left).

  4. Toggle Energy Label to enable it.

  5. Save your changes.

3

Adding the Energy Label app block to the Product page

  1. Go to Online store → Themes → Edit theme and open the Product template. Click Add section, switch to the Apps tab, and select Energy Label.

  2. Drag the app block into place — ideally near the product price or buy button.

  3. Adjust the block's appearance using the available styling options — the regulation expects the class letter in the badge to match the font size of your price.

4

Assigning EPREL numbers to products

To display the correct energy badge, show the official energy label, and link the product information sheet (PDF), each energy-efficient product in your catalog must have its EPREL number assigned.

  1. Go to Products in your Shopify admin.

  2. Open the product you want to assign an EPREL number to. Scroll to the Product metafields section and locate the EPREL Registration Number field.

  3. Enter a valid EPREL number and click Save.

Once saved, the storefront will display the official energy badge for that product. Clicking the badge opens a pop-up with the full energy label, while the link next to it opens the product information sheet (PDF) in a new browser tab.

The product information sheet opens in the official language of the customer's country — see Product sheet language. Don't have the EPREL numbers at hand? See Finding EPREL numbers.

Have a large catalog? Assign numbers to many products at once with Bulk assignment.

5

Settings

All app settings live in Apps → EU Energy Label → Settings, and none of them are required for the initial setup — the defaults work as is.

  • Product sheet fallback language Product information sheets open in the official language of each customer's country automatically. This setting applies only when neither the customer's country nor their browser points to an official EU language, and it's prefilled from your store's address — you can usually leave it as is. See Product sheet language for how the language is chosen.

  • Open energy label in a new tab instead of a popup Off by default. Clicking the energy badge opens the official label in a pop-up on the page; turn this on to open it in a new browser tab instead.

  • Enable manual mode Off by default. For legacy products that aren't listed in the EPREL database — turning it on creates three additional product metafields where you set the energy class, label image, and product information sheet manually. See Manual mode for legacy products.


Your product pages now carry badges. Next, show them everywhere else the regulation requires — collection, search, and cart pages: How badge placement works.

Last updated

Was this helpful?