> 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/setup-guide.md).

# Setup guide

{% 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 %}

### 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.

<figure><img src="https://3301369913-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FxVJktUBFEDa8kf65lOm9%2Fuploads%2FYSnURco3bHaL0ZuA37x1%2Fimage.png?alt=media&#x26;token=6cc4e9c6-ca2a-4e9c-a540-d64bb2fa2357" alt=""><figcaption></figcaption></figure>
{% 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 — the regulation expects the class letter in the badge to match the font size of your price.

<figure><img src="https://3301369913-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FxVJktUBFEDa8kf65lOm9%2Fuploads%2FEB0b5HihspelgAhmsGZW%2Fimage.png?alt=media&#x26;token=29471605-e69d-4808-940f-a3edf06716f4" alt=""><figcaption></figcaption></figure>
{% endstep %}

{% step %}

### 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.

{% hint style="info" %}
The **product information sheet** opens in the official language of the customer's country — see [Product sheet language](/docs/energy-label/localization/product-sheet-language.md). Don't have the EPREL numbers at hand? See [Finding EPREL numbers](/docs/energy-label/displaying-energy-labels/finding-eprel-numbers.md).
{% endhint %}

<figure><img src="https://3301369913-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FxVJktUBFEDa8kf65lOm9%2Fuploads%2FDHQI8rUHAKRDLnsPabux%2Fimage.png?alt=media&#x26;token=6261bacd-d5ab-436d-bf4f-b798f87a9fd1" alt=""><figcaption></figcaption></figure>

Have a large catalog? Assign numbers to many products at once with [Bulk assignment](/docs/energy-label/displaying-energy-labels/bulk-assignment.md).
{% endstep %}

{% step %}

### 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](/docs/energy-label/localization/product-sheet-language.md) 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](/docs/energy-label/special-cases/manual-mode-for-legacy-products.md).
  {% endstep %}
  {% endstepper %}

***

Your product pages now carry badges. Next, show them everywhere else the regulation requires — collection, search, and cart pages: [How badge placement works](/docs/energy-label/displaying-energy-labels/how-badge-placement-works.md).


---

# 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/setup-guide.md?ask=<question>&goal=<endgoal>
```

`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.