> For the complete documentation index, see [llms.txt](https://staylime.com/docs/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://staylime.com/docs/energy-label/getting-started.md).
# Getting started
{% stepper %}
{% step %}
### Installing the app
You can install the EU Energy Label app directly from the Shopify App Store:
1. On the [app listing page](https://apps.shopify.com/eu-energy-label), 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.
{% endstep %}
{% step %}
### Localization
Go to **Apps → EU Energy Label → Settings** and set your preferred language under **Product sheet language**.
This setting determines:
* The language of the product information sheet (`PDF`)
* The link text displayed next to the energy badge
{% hint style="warning" icon="lightbulb" %}
The following languages are currently supported for product information sheets:\
🇬🇧 English (Default), 🇩🇪 Deutsch, 🇫🇷 Français, 🇪🇸 Español, 🇮🇹 Italiano, 🇳🇱 Nederlands, 🇵🇱 Polski, 🇸🇪 Svenska, 🇩🇰 Dansk, 🇫🇮 Suomi, 🇬🇷 Ελληνικά, 🇧🇬 Български, 🇨🇿 Čeština, 🇷🇴 Română, 🇭🇷 Hrvatski, 🇭🇺 Magyar, 🇪🇪 Eesti, 🇱🇹 Lietuvių, 🇱🇻 Latviešu, 🇸🇰 Slovenčina, 🇸🇮 Slovenščina, 🇲🇹 Malti, 🇵🇹 Português
{% endhint %}
{% endstep %}
{% step %}
### 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.
{% endstep %}
{% step %}
### 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.
{% hint style="warning" icon="lightbulb" %}
**Link text** allows you to customize the wording for the **Product Information Sheet** text that appears next to the energy badge — it will override the default value.
{% endhint %}
{% endstep %}
{% step %}
### Assigning EPREL numbers to products
To display the correct energy badge, show the official energy label, and enable PDF download of the product information sheet, 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 on the energy badge will open the pop-up with full energy label, and the product information sheet link will download a localized product fiche in PDF format.
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 product information sheet link downloads the localized fiche in PDF format.
{% hint style="warning" icon="lightbulb" %}
The **product information sheet** will be downloaded in the language you selected earlier in [Step 2: Localization](#localization).
{% endhint %}
#### Assigning EPREL numbers in bulk
To assign EPREL numbers to multiple products at once, follow these steps:
1. In your Shopify admin, go to **Products** and select all relevant items. Click **Bulk edit**.
2. In the bulk editor view, click **Columns** in the top right corner. Scroll to **Metafields**, then check **EPREL Registration Number** to make the column visible.
3. Enter the correct EPREL number for each product in the newly visible field. Click **Save** in the top bar to apply the changes.
Once saved, the energy badges, labels, and product fiches will be available on the storefront for all products with valid EPREL numbers.
{% endstep %}
{% endstepper %}
---
# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.
## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.
Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter:
```
GET https://staylime.com/docs/energy-label/getting-started.md?ask=&goal=
```
`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.
Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.