> For the complete documentation index, see [llms.txt](https://docs.thunkable.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.thunkable.com/app-design/ui-components/basic-components/label.md).

# Label Component

## Overview

The label component is used to display read-only text and can be made clickable using blocks.

Labels work alongside other user interface components like buttons, images, and text inputs to create a cohesive and intuitive user experience.&#x20;

<figure><img src="/files/m9ZXx6bZPmFUk4a0LSJf" alt=""><figcaption></figcaption></figure>

## Properties

You can customize your label using the following properties:&#x20;

### Label

<table><thead><tr><th width="216.69525053355846">Property</th><th width="183.58335031860162">Value</th><th>Description</th></tr></thead><tbody><tr><td>Text</td><td>Text</td><td>Text that appears on the label</td></tr><tr><td>Font</td><td>Select from menu</td><td>Font used to display label's text</td></tr><tr><td>Custom Font (mobile only)*</td><td>OTF or TTF file</td><td>Font used to display label's text</td></tr><tr><td>Color</td><td>Color</td><td>Color of the text that appears on the label</td></tr><tr><td>Font Weight</td><td>True/False</td><td>Make the label's text bold</td></tr><tr><td>Font Style</td><td>True/False</td><td>Make the label's text italicized</td></tr><tr><td>Underline</td><td>True/False</td><td>Underline the label's text</td></tr><tr><td>Strikethrough</td><td>True/False</td><td>Apply strikethrough formatting to the label's text. You can further select the strikethrough's color and style. </td></tr><tr><td>Text Align</td><td>Select from menu</td><td>Set alignment of the text relative to the label's outline</td></tr><tr><td>Font Size</td><td>Number</td><td>Size of the text that appears on the label</td></tr><tr><td>Number Of Lines</td><td>Number</td><td>Maximum amount of lines of text that your label will display</td></tr></tbody></table>

{% hint style="info" %}
Custom Fonts may only be available for Creators on certain Thunkable plans. [Read more about our pricing plans here.](https://thunkable.com/#/pricing)
{% endhint %}

### Advanced Properties

| Property                                           | Value                                             | Description                            |
| -------------------------------------------------- | ------------------------------------------------- | -------------------------------------- |
| <p>Writing Direction </p><p>(iOS and web only)</p> | Select from list `[left-to-right, right-to-left]` | Writing direction of your label's text |
| <p>Letter Spacing </p><p>(iOS and web only)</p>    | number                                            | Spacing between letters of your label  |

### **Layout**

<table><thead><tr><th width="160.57888762769582">Property</th><th width="173">Value</th><th>Description</th></tr></thead><tbody><tr><td>X</td><td>coordinate value</td><td>Position of the upper left corner of the label on the X-axis, where the left side of the screen is X=0.</td></tr><tr><td>Y</td><td>coordinate value</td><td>Position of the upper left corner of the label on the Y-axis, where the top of the screen is Y=0.</td></tr><tr><td>Height</td><td>number in pixels</td><td>The label's height is defined by a custom number of pixels.</td></tr><tr><td>Width</td><td>number in pixels</td><td>The label's width is defined by a custom number of pixels.</td></tr><tr><td>Resize Mode</td><td>Stretch</td><td>Stretches the label's to fit the dimensions of the device's screen.</td></tr><tr><td>Resize Mode</td><td>Float in Place</td><td>Renders the label in the same aspect ratio as the design, regardless of the device size.</td></tr></tbody></table>

### Style

<table><thead><tr><th width="197.33333333333331">Property</th><th width="252">Value</th><th>Description</th></tr></thead><tbody><tr><td>Visible</td><td>visible</td><td>Users can see the label.</td></tr><tr><td>Visible</td><td>invisible</td><td>Users cannot see the label.</td></tr><tr><td>Background Color</td><td>color</td><td>The background color of the label.</td></tr><tr><td>Border: Style</td><td>solid</td><td>The label's border is a solid line.</td></tr><tr><td>Border: Style</td><td>dotted</td><td>The label's border is a dotted line.</td></tr><tr><td>Border: Style</td><td>dashed</td><td>The label's border is a dashed line.</td></tr><tr><td>Border: Color</td><td>color</td><td>The label's border is the color selected. </td></tr><tr><td>Border: Width</td><td>number in pixels</td><td>The width of the label's border is defined by a custom number of pixels.</td></tr><tr><td>Border: Radius</td><td>number in pixels</td><td>The radius of the label border’s corners is defined by a custom number of pixels.</td></tr><tr><td>Shadow: Color</td><td>color</td><td>The label's shadow is the color selected. </td></tr><tr><td>Shadow: Opacity</td><td>number between 0 and 100</td><td>The opacity of the label's shadow. </td></tr><tr><td>Shadow: Radius</td><td>number in pixels</td><td>The radius of the label shadow’s corners is defined by a custom number of pixels.</td></tr><tr><td>Shadow: Offset</td><td>number in pixels</td><td>How far the label's shadow should be offset, in height and width, is defined by a custom number of pixels.</td></tr></tbody></table>

## Label Blocks

To access the blocks specific to the label component:

1. On the Design tab, add a **Label** component to a screen.
2. Navigate to the **Blocks** tab.
3. In the component tree on the left, click the name of the label component.
4. A drawer of label-specific blocks opens.

| Block Image                                                                                         | Description                                                                                                                                                                                                                                    |
| --------------------------------------------------------------------------------------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| ![](/files/xM084TyQt6caFgcbnR9p)                                                                    | This event will fire when the user clicks on the label.                                                                                                                                                                                        |
| ![](/files/9mL2WAreOkXzQ0aHMoiJ)                                                                    | Set the label's text. This property corresponds to the text that is displayed in the label component.                                                                                                                                          |
| ![](/files/reOVxhJnozfvlCeFWuzK)                                                                    | Get the label's text.                                                                                                                                                                                                                          |
| ![](/files/ntsBDyxvNwcZR0dCk5yc)                                                                    | Set the label's font size.                                                                                                                                                                                                                     |
| ![](/files/Yym5pEpsjg8d49Z0kIF9)                                                                    | Get the label's font size.                                                                                                                                                                                                                     |
| <div><figure><img src="/files/oyv0X9rRHmLGbYsMptip" alt=""><figcaption></figcaption></figure></div> | Set the label's font.                                                                                                                                                                                                                          |
| <div><figure><img src="/files/W1dJBuODetfNhskI7el5" alt=""><figcaption></figcaption></figure></div> | Get the label's font.                                                                                                                                                                                                                          |
| <div><figure><img src="/files/n2PHDve08NJ2l9VHoVjW" alt=""><figcaption></figcaption></figure></div> | Set the label's custom font.                                                                                                                                                                                                                   |
| <div><figure><img src="/files/Gj7HYChgaSJRtDwHpBdu" alt=""><figcaption></figcaption></figure></div> | Get the label's custom font.                                                                                                                                                                                                                   |
| ![](/files/nsodzbvSDbK2LceNrj5c)                                                                    | Set the label's number of lines.The number of lines property is used to work with the maximum number of lines of text that should be displayed in a label before that label starts to scroll.                                                  |
| ![](/files/ZrlWMnAU10jRNn6pxB0V)                                                                    | Get the label's number of lines.                                                                                                                                                                                                               |
| <div><figure><img src="/files/9GzxhSA4IQrhtZl3rWo8" alt=""><figcaption></figcaption></figure></div> | Set the label's line height.                                                                                                                                                                                                                   |
| <div><figure><img src="/files/HWKJso2cGKOQtJi4iaLk" alt=""><figcaption></figcaption></figure></div> | Get the label's line height.                                                                                                                                                                                                                   |
| ![](/files/gS3pBcubzCBzPueQEdAP)                                                                    | Set the label's color. Best practice is to use one of the [color blocks](/blocks/blocks/color.md) to set this value, but HEX or RGB values may be used too.                                                                                    |
| ![](/files/SJ54ppXyhwvLpMOUa812)                                                                    | Get the label's color.                                                                                                                                                                                                                         |
| ![](/files/ZN4JKE7GMQVV19ONAqqN)                                                                    | Set the label's background color with the color of the label itself i.e. the region behind the label text. Best practice is to use one of the [color blocks](/blocks/blocks/color.md) to set this value but HEX or RGB values may be used too. |
| ![](/files/9iSU6wSrLHGetAKn72N6)                                                                    | Get the label's background color.                                                                                                                                                                                                              |
| ![](/files/FOuHnkPjfKOXeSVURdLa)                                                                    | Set the label's font style. The font style property can be either "Normal" or "*Italic".*                                                                                                                                                      |
| ![](/files/0tx5MYKegIRgZOUP6JQG)                                                                    | Get the label's font style.                                                                                                                                                                                                                    |
| ![](/files/RWSSJwgBoN29md7nGmWz)                                                                    | Set the label's font weight. The font weight value can be either "Normal", "**Bold**" or a value from 100 to 900                                                                                                                               |
| ![](/files/HBi346QdtdWFLFEhWlns)                                                                    | Get the label's font weight.                                                                                                                                                                                                                   |
| ![](/files/s2JI0ClEYKlrgtDTrT3F)                                                                    | <p></p><p>Set the label's Text Align. Text Align can be any of the following values: Auto, Left, Right, Center, or Justify.</p>                                                                                                                |
| ![](/files/1U8bXjexcwYGDE4lMKrF)                                                                    | Get the label's Text Align.                                                                                                                                                                                                                    |
| <div><figure><img src="/files/DSshMzl5pibiATzCZHm3" alt=""><figcaption></figcaption></figure></div> | Set the label's border color. Best practice is to use one of the [color blocks](/blocks/blocks/color.md) to set this value but HEX or RGB values may be used too.                                                                              |
| <div><figure><img src="/files/o3z2m7GtxHKKmqzy5TwA" alt=""><figcaption></figcaption></figure></div> | Get the label's border color.                                                                                                                                                                                                                  |
| <div><figure><img src="/files/bhK1aymcpLuMyhZhHKMn" alt=""><figcaption></figcaption></figure></div> | Set the label's border width.                                                                                                                                                                                                                  |
| <div><figure><img src="/files/3Girus0zlHdzVdU8ajpW" alt=""><figcaption></figcaption></figure></div> | Get the label's border width.                                                                                                                                                                                                                  |
| ![](/files/PV9LckBRUr7B3dn0cWQM)                                                                    | <p></p><p>Set the label's height. Acceptable input values are: Number of Pixels, Percentage Height, "Fit Contents", or "Fill Container."</p>                                                                                                   |
| ![](/files/Ofnl3NG6B97ASPM78VUo)                                                                    | Get the label's height.                                                                                                                                                                                                                        |
| ![](/files/eNGWZEv3XHdtljGD1JNQ)                                                                    | The `Computed Height` block gets the on-screen dimensions of the label, after it has been rendered on-screen. The value returned is an integer, representing the size of the label in pixels.                                                  |
| ![](/files/tCsajY0C9eZq4t7zbCwf)                                                                    | Set the label's width. The width blocks work with the Width property of the label component. Acceptable values are.‌                                                                                                                           |
| ![](/files/M0yAkzJvDgZXtiqtThAy)                                                                    | Get the label's width.                                                                                                                                                                                                                         |
| ![](/files/RjwExRo4ScvmaXRu6HtZ)                                                                    | The `Computed Width` block gets the on-screen dimensions of the label, after it has been rendered on-screen. The value returned is an integer, representing the size of the label in pixels.                                                   |
| ![](/files/dV0usWsGZRvYlzHt1UoZ)                                                                    | Set the label's Visibility. The visible blocks are used to show or hide the entire image component. Acceptable values are: true or false.                                                                                                      |
| ![](/files/GulKoJPtt6gMjIlBB0L9)                                                                    | Get the label's Visibility.                                                                                                                                                                                                                    |
| <div><figure><img src="/files/LjBLKoJgbR1i92iDZSfx" alt=""><figcaption></figcaption></figure></div> | Set the label's X coordinate.                                                                                                                                                                                                                  |
| <div><figure><img src="/files/sq1OYXmm5a2aJ2J1BtaG" alt=""><figcaption></figcaption></figure></div> | Get the label's X coordinate.                                                                                                                                                                                                                  |
| <div><figure><img src="/files/pNi8bXsQyMEkXAtb3ur0" alt=""><figcaption></figcaption></figure></div> | Set the label's Y coordinate.                                                                                                                                                                                                                  |
| <div><figure><img src="/files/XmEIKZH8WHKA6pQYMMcp" alt=""><figcaption></figcaption></figure></div> | Get the label's Y coordinate.                                                                                                                                                                                                                  |
