# Home page

The home page of a project in Eliona provides a quick overview of important information and widgets relevant to the project. It is shown first when opening a project or after logging in. There you can see the **project overview** with the created elements, direct access to the **project settings**, a **Map** with the project location and a **weather widget**that shows the current weather and the forecast for the location.

<div data-full-width="true"><figure><img src="https://content.gitbook.com/content/Nyvwhz1kEMXcHf4HLuZ8/blobs/raVhblwP2PPTdXl4zq3a/Start%20seite%20(4).png" alt=""><figcaption></figcaption></figure></div>

<table data-header-hidden data-full-width="true"><thead><tr><th width="88"></th><th width="237"></th><th></th></tr></thead><tbody><tr><td><strong>[1]</strong></td><td><strong>project overview</strong> </td><td>Displays the created and configured elements, such as asset data, status overviews, or alarms, that were added manually. <a href="#element-konfigurieren">-> configure element</a></td></tr><tr><td><strong>[2]</strong></td><td><strong>project settings</strong></td><td>Allows direct access to the project settings, where configurations and adjustments can be made. <a href="#startseite-konfigurieren">-> configure home page</a></td></tr><tr><td><strong>[3]</strong></td><td><strong>Map</strong></td><td>Displays a map with the locations of the assets selected in the elements.</td></tr><tr><td><strong>[4]</strong></td><td><strong>weather widget</strong></td><td><p>Displays the current weather as well as a weather forecast for the coming days based on the user's location.</p><p>The weather widget uses the following priority for determining the location:</p><ol><li>Location in the user profile</li><li>Location in the project role</li><li>If no location is specified, the location of your office is used.</li></ol><p> <a href="../widgets/predefined-widgets/weather">-> weather widget</a></p></td></tr></tbody></table>

## Configure home page

<figure><img src="https://content.gitbook.com/content/Nyvwhz1kEMXcHf4HLuZ8/blobs/9x2wBIDq1sBdOIYX1WJx/Start%20seite.png" alt=""><figcaption></figcaption></figure>

Follow these steps to set up a home page for your project:

1. **Open Engineering**\
   Click in the sidebar on **Engineering \[A]**\
   ▷ The menu **Engineering** opens.
2. **Open projects**\
   Select the item **Projects \[B]**\
   ▷ The project overview is displayed.
3. **Open project**\
   Open the desired project **\[C]**\
   ▷ The project settings are loaded.
4. **Activate home page**\
   Activate the option **Home page** in the project settings **\[D]**\
   ▷ The home page is set for this project.
5. **Add element to home page**\
   Add an element to the home page by clicking on **"Add element"** click **\[E]**<br>

## Configure element

To add a new element to the home page, click **+Add element** \[E]. If you want to edit an existing element, click the **pencil button**to open the configuration.

<figure><img src="https://content.gitbook.com/content/Nyvwhz1kEMXcHf4HLuZ8/blobs/NLm7VyhZQrcZPDq32OzH/Start%20seite%20(2).png" alt=""><figcaption></figcaption></figure>

<figure><img src="https://content.gitbook.com/content/Nyvwhz1kEMXcHf4HLuZ8/blobs/8UbfKo3GThW4EtDQj0gu/Start%20seite%20(3).png" alt=""><figcaption></figcaption></figure>

<table data-header-hidden data-full-width="true"><thead><tr><th width="81"></th><th width="229"></th><th></th></tr></thead><tbody><tr><td><strong>[F]</strong></td><td>Set name</td><td>Enter a name for the element. The name is displayed as the heading for the element on the home page.</td></tr><tr><td><strong>[G]</strong></td><td>Add description</td><td>Write a short description; the description is displayed below the name in the element.</td></tr><tr><td><strong>[H]</strong></td><td>Select asset</td><td>Select the asset to be linked to the element by clicking <strong>Search asset</strong> this links the element to a specific asset and its data are displayed in the element.</td></tr><tr><td><strong>[I]</strong></td><td>Add image</td><td>Optionally, you can upload an image to visually support the element. A square image with a 1:1 ratio is recommended to ensure optimal display.</td></tr><tr><td><strong>[J]</strong></td><td>Select element attribute</td><td>Select the attributes that should be listed on the home page at the bottom of the element, e.g. a measured value or a status value of the linked asset.</td></tr><tr><td><strong>[K]</strong></td><td>Save</td><td>Click on <strong>Save</strong>, to add the element to the home page or apply the changes.</td></tr></tbody></table>


---

# Agent Instructions: 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:

```
GET https://docs.buildings.ability.abb/collection/english-v14/documentation/systems-and-projects/home-page.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
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.