# Start Page

The home page of a tenant in BuildingPro Suites offers a quick overview of important information and widgets that are relevant to the tenant. It is the first thing that is displayed when a tenant is opened or after logging in. There you will see the **Tenant Overview** with the created elements, direct access to the **Tenant Settings**, a **Map** with the tenant 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://3489494878-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F9GvUpaatBiReR43XFSMg%2Fuploads%2FmWtjO2hajTusnk7zptm8%2FStart%20seite%20(4).png?alt=media&#x26;token=25c496a3-45cc-4856-8fd4-bdc0306a7e67" alt=""><figcaption></figcaption></figure></div>

<table data-full-width="true"><thead><tr><th width="60.79998779296875"></th><th width="173"></th><th></th></tr></thead><tbody><tr><td><strong>[1]</strong></td><td><strong>Tenant Overview</strong></td><td>Displays the created and configured elements, such as asset data, status overviews, or alarms that have been added manually. <a href="#configure-element">-> Configure element</a></td></tr><tr><td><strong>[2]</strong></td><td><strong>Tenant Settings</strong></td><td>Allows direct access to the tenant settings, where configurations and adjustments can be made.<a href="#configure-home-page"> -> 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 location determination:</p><ol><li>Location in the user profile</li><li>Location in the assigned role</li><li>If no location is specified, it falls back to the location of your office.</li></ol><p>-> Weather Widget</p></td></tr></tbody></table>

## Configure Home Page

<figure><img src="https://3489494878-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F9GvUpaatBiReR43XFSMg%2Fuploads%2FYrwQldmrRVhTy1F26eWm%2FStart%20seite.png?alt=media&#x26;token=06873746-c631-4b78-a242-7d6a23b45045" alt=""><figcaption></figcaption></figure>

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

1. **Open Engineering** In the sidebar, click on **Engineering \[A]**

   ▷ The **Engineering** menu opens.
2. **Open Tenants** In the context bar, select **Tenants \[B]**

   ▷ The tenant overview is displayed.
3. **Open Tenant** Open the desired tenant **\[C]**

   ▷ The tenant settings are loaded.
4. **Activate Home Page** Activate the **Home Page** option in the tenant settings **\[D]**

   ▷ The home page is set for this tenant.
5. **Add Element to Home Page** Add an element to the home page by clicking on **"Add element"** **\[E]**

## Configure Element

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

<figure><img src="https://3489494878-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F9GvUpaatBiReR43XFSMg%2Fuploads%2FMSMLCP2HRZGdoIsexH6z%2FStart%20seite%20(2).png?alt=media&#x26;token=2e6f5cf3-e78b-465f-89d4-5e998f509bbe" alt=""><figcaption></figcaption></figure>

<figure><img src="https://3489494878-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F9GvUpaatBiReR43XFSMg%2Fuploads%2F1uEsfxlzsDitMvR3atvm%2FStart%20seite%20(3).png?alt=media&#x26;token=392b3fcc-d2a0-43e5-858d-15ef08008892" alt=""><figcaption></figcaption></figure>

<table><thead><tr><th width="56.199981689453125"></th><th width="212.20001220703125"></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, which will be displayed below the name in the element.</td></tr><tr><td><strong>[H]</strong></td><td>Select Asset</td><td>Select the asset that should be linked to the element by clicking on **Search Asset**. This connects the element with a specific asset, and its data is displayed in the element.</td></tr><tr><td><strong>[I]</strong></td><td>Add Image</td><td>Optional, 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 at the bottom of the element on the home page, e.g., a measured variable or a status value of the linked asset.</td></tr><tr><td><strong>[K]</strong></td><td>Save</td><td>Click on **Save** to add the element to the home page or to 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/mandatory-base/platform-core/workspace-and-identity/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.
