# Home

## What makes a good Home?

<figure><img src="/files/uSCDDsGhn2ILYUwlov6n" alt=""><figcaption><p>Home</p></figcaption></figure>

The **Home** is the first thing your users will see. Sometimes, it can also be the only thing they’ll have time to see.

Imagine your manager going into a meeting and in the elevator, wanting to see the latest numbers.

Think of the top indicators that will make your user a rock star in any situation.

Here are a few tips for you to keep in mind when building a home page:

* Understand your user’s needs before you start
* A home page is not exhaustive, it can change and be updated
* Choose meaningful indicators that tell a story
* One indicator = one message

### How to create the Home?

cf. [Creating the Home](/visualizations-and-layouts/apps/home/creating-the-home.md)

### Title

Would you read a book without a title?

Give your home a title in a few clicks. Let your users know what this is all about.

* *Are you doing some “Retail monitoring”, or some “Brand management”?*

### Categories

To be readable and understandable by all, your home page should be organized.

Use **categories** as a reading grid to help your users better navigate through all the indicators at their disposal.

<figure><img src="/files/KO762QTI5SWPKOUc7Be5" alt=""><figcaption><p>Home - Categories and tiles</p></figcaption></figure>

## Tiles

#### What is a Tile?

A tile is a small card containing data you want to display. See it as a mini viz with *limited* options that will be displayed on the home page.

Tiles are not only diagrams but can also be media or editorial content like text, images, or videos.

#### Why limited options?

Several indicators are presented on the homepage. As a consequence, the homepage needs to be as clear and concise as possible to catch the user’s attention. Therefore, you cannot use regular charts that require more space here like you would in stories. We’ve crafted a set of small visualizations specially designed to be overseen and yet understood in a glimpse: we’ve called them tiles.

Tiles are much more limited than regular charts to make sure you keep your home as lightweight as possible.

#### How to create a Tile?

cf. [Creating Tiles](/visualizations-and-layouts/apps/home/creating-tiles.md)

## Filters

Filters allow you to make your Home and your App totally dynamic! A single user can use them to zoom or drill within indicators based on dimensions such as Dates or entities such as Country, Product Line, and so on.

<figure><img src="/files/g3uvuSEYR5Ix7FWVTzY9" alt=""><figcaption><p>Home - Filters</p></figcaption></figure>

#### How to create a Filter?

cf. [Creating Filters](/visualizations-and-layouts/apps/filters/managing-filters/creating-reusing-and-editing-filters.md)


---

# 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-v3.toucantoco.com/visualizations-and-layouts/apps/home.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.
