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

# Text

> Text elements allow you to communicate information in markdown to your customers.

## What it does

<img src="https://mintcdn.com/explo/CaJC4DeBEWf_KlnL/images/creating-dashboards/text-1.png?fit=max&auto=format&n=CaJC4DeBEWf_KlnL&q=85&s=14e7787bc1e6d09b2ca4491062a26726" alt="" width="202" height="238" data-path="images/creating-dashboards/text-1.png" />

This component allows you to add a block of text to your dashboard. Use this
component for any labeling and providing additional information for your user.

The **Text Component** supports Markdown to give you the flexibility to
configure the style and sizing of your text. You can reference the article
[here](https://www.markdownguide.org/basic-syntax/) for Markdown.

You can also utilize variables in your text component by using the
`{{element#}}`notation. This is great for adding company names into your
dashboards or dynamically describing charts and graphs.

## Configuration

<img src="https://mintcdn.com/explo/CaJC4DeBEWf_KlnL/images/creating-dashboards/text-2.png?fit=max&auto=format&n=CaJC4DeBEWf_KlnL&q=85&s=0c2cd2ab6e95851c9fa967636b6793a7" alt="Configuration for a text element" width="432" height="481" data-path="images/creating-dashboards/text-2.png" />

| Configuration Option | Description                                                                                                                                                                                                                                                                                                                                                        |
| -------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |
| Text                 | This is a text area that allows you to type in free form text. Our text elements understand markdown, enabling you to make complex text views in your dashboards.                                                                                                                                                                                                  |
| Text Size            | This allows you to manage the size of the text that appears on the dashboard.<br />There are three options:<br />• Normal (default)<br />• Large<br />• Extra Large                                                                                                                                                                                                |
| Alignment            | Alignment defines the horizontal & vertical placement of the text inside of the container on the dashboard. There are 3 options in the horizontal direction:<br />• Left aligned (default)<br />• Center aligned<br />• Right aligned<br />There are 3 options in the vertical direction:<br />• Top aligned (default)<br />• Center aligned<br />• Bottom aligned |

## Markdown formatting

The text element uses markdown formatting to format the text onto the page. This
gives you access to powerful text formatting.

Please reference a markdown guide, such as
[this one](https://www.markdownguide.org/basic-syntax/), for more information on
the specific syntax available.

## Dynamically Generated Values

You may use dynamically generated values in your text elements by using the
`{{ }}` notation, similar to the dataset SQL editor. These values can either be
generated from custom variables or through data queried against your Explo
datasets.

### Using Variables

The variables you have access to are all the variables in the page defined by
user inputs, the customers, and passed in from the embedded component.

<img src="https://mintcdn.com/explo/CaJC4DeBEWf_KlnL/images/creating-dashboards/text-3.png?fit=max&auto=format&n=CaJC4DeBEWf_KlnL&q=85&s=ca7037641a79e2781fe16db2d375b364" alt="A variable being used in a text component" width="1266" height="426" data-path="images/creating-dashboards/text-3.png" />

For example, in the above dashboard we are using the `customer_name` variable
to make the text shown on the screen be dynamic.

### Using Datasets

For dynamic values from datasets, you need to supply both the table name and the
column you would like read from. Explo will select the first row of whatever
column and table you specify, so you will likely want to make a specific dataset
that aggregates a value and then pass that dataset to the text component.

<img src="https://mintcdn.com/explo/CaJC4DeBEWf_KlnL/images/creating-dashboards/text-4.png?fit=max&auto=format&n=CaJC4DeBEWf_KlnL&q=85&s=77518a99d96358d27717fc34bed9c718" alt="A dataset being used in a text component" width="1296" height="344" data-path="images/creating-dashboards/text-4.png" />

For example, in the above dashboard we are using the *customers* column from
*dataset1* to make the text shown on screen to be dynamic.
