> ## Documentation Index
> Fetch the complete documentation index at: https://docs.retail-q.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Components

> Add visualizations, notes and tables to dashboards

Dashboards are collections of data visualizations like graphs, tables, numbers, and components like text blocks and headers.

## Creating and modifying components

<Note>You can't edit or create components on mobile</Note>

1. With a dashboard open, scroll to the bottom of the page
2. Click the 'Add item' button, and select the type of component you'd like to create
3. By default, the new component is added to the end of the dashboard.

The new component will be opened by default so that you can use the sidebar to edit its contents or title.

### Setting the contents

The new component will be opened by default. You can also click the Pencil button that appears if you hover over the component (next to the drag handle).

The types of data you can select depends on the type of visualization. For example, in a line graph, you'll only be able to select one dimension, but in a table can select multiple.

* **Measures:** these are the numerical 'values' of the visualization, like sales, quantity or conversion percentage
* **Dimensions:** these determine how the measures are broken down. In 'sales by product category', product category would be a dimension
* **Title:** the label of the visualization

### Editing and moving components

<Note>The move and edit buttons don't appear on mobile. Use a desktop instead.</Note>

When hovering over a component in the dashboard, a movement button and edit button will appear in the top right corner.

Drag and drop the component when the mouse is over the movement button.

Click the edit button to open the sidebar menu on the right.

## Types of components

There are many different components you can add to dashboards:

| Type           | Description                                         | Measure           | Dimension                                         |
| -------------- | --------------------------------------------------- | ----------------- | ------------------------------------------------- |
| **Line chart** | Time-series chart of a metric over time             | Exactly one       | Optional. Dimension values become different lines |
| **Number**     | Single number displayed as a KPI                    | Exactly one       | None                                              |
| **Table**      | Spreadsheet-like data table                         | As many as needed | As many as needed                                 |
| **Bar chart**  | Vertical bar list, useful for showing a ranked list | Exactly one       | As many as needed                                 |
| **Heading**    | Header text to separate sections of the dashboard   | N/A               | N/A                                               |
| **Text**       | Text to add notes to the dashboard                  | N/A               | N/A                                               |